# Preview: Notion-flavored Markdown with markdown\_version

By Steven Van · 2026-09-30

Enhanced markdown remains the default, and the opt-in v2 preview does not yet support include\_transcript.

Developers can opt into [Notion](<https://creatorstoolbox.com/tools/notion>)’s new Markdown format by setting the optional markdown\_version parameter to v2 on markdown endpoints. The preview supports reading and writing Notion-flavored Markdown, while v1, enhanced markdown, remains the default. Requests without the parameter continue to work as before.

## A format for Notion content

Notion-flavored Markdown combines CommonMark with GFM tables, task lists and strikethrough, plus syntax for custom emoji, math and Notion-specific XML tags. Those tags represent content such as callouts, columns, mentions and synced blocks. The [format reference](<https://developers.notion.com/guides/data-apis/notion-flavored-markdown>) shares its specification with the Notion MCP server and is written for AI agents.

## Preview limits and validation

v2 does not yet support include\_transcript, and synchronous v2 updates return parser warnings. Sending markdown\_version without markdown on POST /v1/pages or the comment endpoints returns a 400 validation\_error.

![Notion](<https://www.google.com/s2/favicons?domain=notion.so&sz=128>)

Notion

All-in-one workspace for notes, docs, projects, and wikis — with AI built in for writing, summarizing, and organizing.

[View Notion →](<https://creatorstoolbox.com/tools/notion>)

[Original source](<https://developers.notion.com/page/changelog#september-30-2026>)

[Read Preview: Notion-flavored Markdown with markdown\_version on Creators Toolbox](<https://creatorstoolbox.com/blog/notion-preview-notion-flavored-markdown-with-markdown-version>)

---
Canonical source: https://creatorstoolbox.com/blog/notion-preview-notion-flavored-markdown-with-markdown-version