How to Export Notion Pages to Markdown (2026 Guide)

Published

Notion is a powerful workspace for notes, documentation, and project management. But when you need to migrate your content to a static site, documentation platform, or version-controlled repository, Markdown is the universal export format. This guide covers every method to export Notion pages to clean Markdown.


Method 1: Built-in Notion Export (Recommended)

Notion includes a built-in export feature that outputs Markdown files.

For Individual Pages

  1. Open the page you want to export in Notion
  2. Click the three dots menu (⋯) in the top-right corner
  3. Go to Export
  4. Select Markdown & CSV as the export format
  5. Choose whether to include databases and subpages
  6. Click Export

Notion will download a .zip file containing your page as a .md file and a folder with any embedded images.

For Entire Workspaces

  1. Go to Settings & Members → Settings → Export content
  2. Select Export all workspace content
  3. Choose Markdown & CSV as the format
  4. Click Export all

This downloads a zip of all your pages as individual Markdown files, organized by folder structure.

What Export Preserves

ElementPreservedNotes
Headings (H1–H3)YesConverted to Markdown headings
Bold, Italic, StrikethroughYesStandard Markdown formatting
Bullet and numbered listsYesProper nesting preserved
To-do listsYesConverted to GFM task lists
Toggle listsYesConverted to HTML details/summary or simplified
Inline code and code blocksYesLanguage tags preserved
TablesYesSimple Markdown tables
ImagesYesSaved to companion folder, referenced in .md
LinksYesStandard Markdown links
CalloutsPartialSimplified to blockquotes
Database viewsPartialExported as plain text or tables
EmbedsNoNot included in export

Method 2: Copy and Paste as Markdown

For single pages or sections, copy-paste works well for basic content.

  1. Select the content in Notion and copy it (Ctrl+C / Cmd+C)
  2. Open our online Markdown editor
  3. Paste directly into the editor

Notion copies rich text to the clipboard. When you paste into a Markdown editor, most formatting transfers. This method is quick but may not preserve complex layouts perfectly.

Paste as Plain Text

If you want to strip all formatting and get plain Markdown source:

  1. Copy from Notion
  2. Paste into a plain text editor first (like Notepad)
  3. Copy the plain text
  4. Paste into your Markdown file
  5. Add formatting manually

Method 3: Using Notion-to-MD CLI Tool

For developers and power users, the open-source Notion-to-MD tool provides fine-grained control over Notion to Markdown exports.

npm install -g notion-to-md

# Export a page by its Notion URL
n2m https://www.notion.so/your-page-slug-123abc

This tool preserves more formatting details and can be integrated into automated workflows.

Cleaning Up Exported Markdown

Notion's export is good, but you may need to clean up:

  • Remove extra blank lines — Notion adds generous spacing between blocks
  • Fix image paths — Images are in a companion folder; adjust paths if moving files
  • Simplify callouts — Replace callout blockquotes with simple blockquotes or notes
  • Rebuild database tables — Database views export as simplified text; restructure as Markdown tables
  • Add front matter — For static sites, add YAML or JSON front matter with title, date, and tags

Converting Notion Export to Other Formats

Once you have clean Markdown from Notion, you can convert it to any format:

Related Guides

Frequently Asked Questions