vust

Markdown Β· Notion to MD

Convert Notion Export to Clean Markdown

Notion exports its pages as Markdown β€” but with quirky formatting. Paste your export here for cleaned-up MD ready for Jekyll, Hugo, or GitHub.

Free Β· No signup Β· Instant

Free, no signup. Up to 1 MB per request.

Clean Notion quirksInstantFrontmatter aware

This tool handles

  • Notion frontmatter strip
  • Emoji callouts β†’ GFM admonitions
  • Database exports (MD tables passthrough)
  • Inline formatting preserved

Not in scope

  • Notion internal hash URLs (kept as-is)
  • Toggles (flatten to headings)
  • Attribute substitution

Try it live with the widget above β€” paste and see the output instantly. For the items under β€œNot in scope,” the migration guide below covers workarounds and when to use a different tool.

Notion to Markdown examples

Paste real Notion in the left column, see the Markdown output on the right.

Page with callout

Notion

> πŸ’‘ This is a Notion tip

Markdown

> [!TIP] This is a Notion tip

Exported page with metadata header

Notion

Created: Jan 1, 2026 Last edited: Feb 1, 2026 # My Page Body.

Markdown

# My Page Body.

Unknown emoji callout fallback

Notion

> πŸŽ‰ party mode

Markdown

> [!NOTE] party mode

How Notion-to-Markdown conversion works

01

Export from Notion β€” In Notion, File β†’ Export β†’ Markdown & CSV. Open the exported .md file.

02

Paste the Markdown β€” Paste the Markdown content into the input field on this page.

03

Convert β€” Click Convert β€” Notion quirks are cleaned up and callouts are mapped to GFM admonitions.

Notion edge cases we handle

Frontmatter strip

`Created:` / `Last edited:` lines at the top of Notion exports are removed automatically.

Callout emoji β†’ admonition

πŸ’‘ β†’ TIP, ⚠️ β†’ WARNING, ❗ β†’ IMPORTANT, πŸ“ β†’ NOTE, πŸ”₯ β†’ CAUTION. Unknown emoji defaults to NOTE.

Database tables pass through

Notion database exports include standard Markdown tables β€” these are preserved verbatim.

Internal links kept as-is

Notion internal page links (hash-based URLs) are preserved; update them by hand for your target platform.

Frequently asked questions

Process bigger files in @vustMarkdownBot

500-character free conversions in chat β€” pay-as-you-go for longer text.

Open Telegram bot
    Notion Export to Markdown Cleaner β€” VUST