Notion adds a Markdown API for reading and writing content

By Steven Van · 2026-05-13

Developers can now use Markdown instead of Notion's block-based JSON, a feature Notion says was most requested.

Notion has shipped a Markdown API, letting developers read and write Notion content as Markdown instead of Notion's block-based JSON format. Notion says it was the most requested developer feature.

The release also comes with a recap of API and MCP improvements Notion has made over the past year:

A Database views API
Personal Access Tokens
A Notion MCP that is 91% more token-efficient
Root page creation
Database locks for read-only access
Database templates
An AI Meeting Notes API
OAuth scoped to a single workspace
A new Developer Portal

Notion

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

View Notion →