Export Notion to Markdown: One Page or Whole Workspace

Export one page or the whole workspace

To export one page, open the ••• menu at the top right of the page and pick Export. The same menu exists on mobile. Choose Markdown & CSV and turn on Include subpages if the page has children. To export the whole workspace, go to Settings in the sidebar, pick General under Workspace, then Export all workspace content. This works on desktop or web only. Workspace export in HTML, Markdown, and CSV is listed on every plan, Free included. The export only holds pages you can access, so other members' private pages are left out. Guests need Full access to a page to see its Export option, and on Enterprise an owner can turn export off.

What arrives and how long it takes

A workspace export always arrives as an emailed link. Notion says the link expires after 7 days and that exports can take up to 30 hours to process. If your email notifications are off, the link goes to your Notion inbox instead. A large page export may be emailed too, but no email is sent if the file downloaded right away. The outer zip has a long name made of IDs. Large workspaces can hold nested zips named Part-1.zip, Part-2.zip, and so on inside it. Notion also says that for very large workspaces the export may have trouble completing. If that happens, export each top-level page on its own with Include subpages turned on.

What the Markdown & CSV export keeps and loses

Regular pages become Markdown files. A full-page database becomes a CSV file plus one Markdown file per row. Images and other files are saved next to the pages in the subpage folders. Callouts come out as raw HTML because Markdown has no callout. A database exports only its current view or its default view, not all views, and form-view databases can't be exported. Notion documents comment export for HTML only, so comments are not in the Markdown files. Every file and folder name ends in a 32-character page ID, and the links between pages point at those names. You also can't rebuild a workspace by uploading the export back into Notion, so treat it as a copy, not a restore point.

Clean the export before you use it

The raw export is hard to use as is. Renaming files by hand breaks every link that points at them. Upload the zip to the Notion to Markdown tool and switch to Clean export (.zip). It strips the IDs from file and folder names, rewrites the links to the new names, adds a Markdown table page for each database, and can turn links into Obsidian [[wiki links]]. It also opens nested Part zips for you. The cleaner runs in your browser, so your files are never uploaded. Download the clean zip and open a few pages to check links and images.

Working example

A page with a subpage exports with an ID on every name. The cleaner removes the IDs and fixes the link.

Projects 3f2a9c1e8b7d4a6f9e0c1b2a3d4e5f60/
  Roadmap 8a1b2c3d4e5f60718293a4b5c6d7e8f9.md

[Roadmap](Projects%203f2a9c1e8b7d4a6f9e0c1b2a3d4e5f60/Roadmap%208a1b2c3d4e5f60718293a4b5c6d7e8f9.md)

Projects/
  Roadmap.md

[Roadmap](Projects/Roadmap.md)

Link targets in the raw export are percent-encoded, so a plain find-and-replace on page titles misses them.