# 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](<https://creatorstoolbox.com/tools/notion>) has shipped a [Markdown API](<https://x.com/i/status/2054725946696241418>), 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

[View media](<https://video.twimg.com/amplify_video/2054725710527537153/vid/avc1/1280x720/1Oseb6m1Hh5dGp5Q.mp4>)

![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>)

[Read Notion adds a Markdown API for reading and writing content on Creators Toolbox](<https://creatorstoolbox.com/blog/notion-markdown-api>)

---
Canonical source: https://creatorstoolbox.com/blog/notion-markdown-api