Sample post — formatting reference (keep as Draft)
Not a real post — shows which Notion blocks the sync understands.
This page stays Draft so it never reaches the site. It exists to show what survives the trip from Notion to markdown.
Headings become markdown headings
Heading 1 → ##, heading 2 → ###, heading 3 → #### (the page title is the article’s <h1>).
-
Bulleted lists work
-
With bold, italic,
inline code,strikethroughand links
-
Numbered lists too
-
Nesting is preserved
Quotes and callouts both become blockquotes.
# code blocks keep their language
print("hello from Notion")Images are downloaded into the repo at sync time (Notion’s own URLs expire, so the file is copied to public/writing/<slug>/). Tables, videos and file attachments are not synced — the script warns and skips them.
To publish a real post: write it, fill Description (and optionally Slug, Date, Tags), flip Status to Published, then run npm run sync:notion in the Site repo and push.