Notion Export to Clean Markdown

What Notion's export gets wrong

When you export a Notion workspace as Markdown, each page becomes a file named like Project Plan a1b2c3…d4e5.md — the trailing 32-hex string is the page's internal id. Pages with subpages also get a sibling folder of the same hashed name holding the children, and images live inside those folders. Notion then writes every internal link and image reference using those hashed, URL-encoded paths.

• Cluttered filenames — every file and folder ends in a long hash.
• Broken-looking links — [Sub](Project%20Plan%20a1b2…/Child%20f6a7….md) instead of [Sub](Project Plan/Child.md).
• Hard to browse — the hashes make the folder tree unreadable in any editor or static-site generator.

What this tool fixes clean

It produces a cleaned .zip that mirrors your workspace structure with:

• De-hashed names — Project Plan a1b2…d4e5.md → Project Plan.md, folders too.
• Rewritten internal links — every link between pages is repointed to the clean path, so cross-references keep working.
• Preserved, re-linked images — image files are copied byte-for-byte and their references updated. Broken images are the #1 migration complaint; they survive here.
• A file/folder that share a name coexist correctly — a page Notes.md and its subpage folder Notes/ both keep the name Notes, exactly as Notion intends.

Databases & what's preserved as-is

Notion databases export as a .csv plus a folder of one Markdown file per row (each row is itself a page with body content). This tool de-hashes and re-links those files but keeps them as files — it does not flatten a database into a single Markdown table, because that would silently drop each row's body content. If you want a database as a Markdown table, run the exported .csv through our CSV to Markdown tool.

Privacy & limits

The entire conversion runs in your browser via a vendored copy of JSZip — your export is never uploaded, and no part of it is sent to a server or any third party. Images are processed in memory and written straight back into the cleaned .zip.

• Size limit: 50 MB for the input .zip (a safe ceiling for in-browser processing). Larger workspaces are rejected with a clear message rather than risking a browser crash.
• Not a Notion export? If the .zip has no hashed Notion filenames, the tool tells you instead of touching your files.
• Works offline once the page and (on first use) the JSZip library have loaded.