Markdown Content API

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

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

This marks a significant shift toward markdown-first content manipulation, making it easier for developers to work with Notion programmatically without navigating the complexity of block structures.

AI Meeting Notes Support

The API now provides first-class support for Notion's AI meeting notes features:

• The markdown retrieval endpoint supports an include_transcript parameter to fetch full meeting transcripts
• New transcription block type enables integrations to read meeting notes metadata including title, status, calendar event details, and references to summary and transcript content blocks

SDK & MCP Enhancements

JavaScript/TypeScript SDK improvements (v5.10.0 and v5.11.0):

• Automatic retry logic with configurable exponential backoff for improved reliability
• Convenience methods pages.retrieveMarkdown() and pages.updateMarkdown() for markdown operations

Notion MCP (Model Context Protocol) updates include block-level comments, Notion Sites viewing, meeting transcript fetching, ~91% context token reduction in schema generation, and enterprise governance features like audit logging and admin tool allowlisting.

Developers should reconnect Notion MCP in third-party AI tools to access the latest features and review security best practices.