Markdown Content API

Notion introduced three new API endpoints that let developers work with page content using enhanced markdown format instead of the traditional block-based approach:

• POST /v1/pages now accepts a markdown parameter as an alternative to the children parameter for creating pages with markdown content
• GET /v1/pages/:page_id/markdown retrieves a page's full content formatted as enhanced markdown
• PATCH /v1/pages/:page_id/markdown allows inserting or replacing content using markdown with ellipsis-based selections for granular updates

The SDK adds corresponding helper methods pages.retrieveMarkdown() and pages.updateMarkdown() for easier integration. Complete documentation is available in the Working with markdown content guide.

SDK Improvements

The JavaScript/TypeScript SDK now includes automatic retry with exponential backoff for failed requests, configurable to match your application's needs. This improves reliability for integrations handling transient failures.

AI Meeting Notes & MCP Enhancements

The markdown retrieval endpoint supports an include_transcript query parameter to include full meeting note transcripts. Notion MCP received significant improvements including ~91% context token reduction in database and data source tools by switching to SQL DDL-based schemas, new tools for querying meeting notes and fetching data sources by ID, and enterprise governance features including audit logging and admin tool allowlisting.

Action Items

• Review the Enhanced markdown format reference to understand the new markdown syntax
• Update your SDK to v5.10.0+ to benefit from automatic retry functionality
• If using Notion MCP with third-party AI tools, reconnect to ensure you have the latest tools and reduced token consumption
• Consult the security best practices guide when deploying MCP integrations