Skip to main content

Available Endpoints

Mark2Notion provides a simple REST API for converting Markdown to Notion blocks and managing Notion page content.

Content Creation & Management

Convert

Convert Markdown text to Notion block JSON without touching Notion

Append

Convert Markdown and append it directly to a Notion page

Append Blocks

Append pre-converted Notion blocks to a page

Clear Page

Archive all content blocks from a Notion page

Content Extraction

Notion to Markdown

Extract content from a Notion page and convert it to Markdown

Authentication

All API endpoints require authentication using an API key passed in the x-api-key header:
Get your API key from the Mark2Notion dashboard.

Common Workflows

Replace Page Content

Clear and update a page in one workflow:

Convert Once, Append Multiple Times

Optimize by converting once and appending to multiple pages:

Rate Limits

All endpoints include automatic retry logic and respect Notion’s rate limits. The API handles:
  • Rate limit responses (429)
  • Transient network errors
  • Notion API throttling
You don’t need to implement retry logic in your code - it’s handled automatically.

Need Help?