Skip to main content
Notion-flavored Markdown is the syntax for markdown_version: "v2" on the markdown endpoints. It’s the recommended syntax, and it becomes the default in the next Notion-Version. See Markdown versions for where to send the parameter. Current Notion-Versions default to v1, the deprecated enhanced markdown syntax. To switch from v1, see Migrate to Notion-flavored Markdown. The specification below comes from the same source as the Notion MCP server’s Markdown spec. It is written for AI agents, so it is terse. You can paste it into your own agent’s prompt.