notion-flavored-markdown

Write the content field in Notion-flavored Markdown: use tabs for nested blocks, set the page title only via properties.title, and use XML-style tags like <callout>, <details>, and <mention-page>. Consult the reference spec before drafting and run the pre-submit checklist before sending.

Replace blank lines with <empty-block/>, convert nested indentation to tabs, escape characters like \ * ~ ` $ [ ] < > { } | ^ outside code blocks, and swap HTML formatting for Notion syntax such as **bold** instead of <strong>. Multi-line quotes and inline code must use <br> instead of raw newlines.

<page> creates or moves a child page into the current page, and removing the tag deletes that child page. <mention-page> is only an inline link reference. Use <mention-page> whenever you just want to link to an existing page without moving it.

Children of <details> toggles, toggle headings, and callouts must be indented with tabs. If children are not tab-indented, they render outside the toggle or callout instead of inside it.

No. Table cells can contain only rich text with Notion-flavored Markdown formatting, not headings, lists, images, or HTML tags. Cell merging is supported in the Notion UI but cannot be created or modified through the API format.

Call create-attachment first, then use the returned file-upload:// URL as the src value in your content. Use <embed> for HTML attachments and <file> for other file types; the source is resolved when the page is saved.