Need AI Training/Help?CloudYeti.io/meet
MarkdownMe
Leaving Notion guide

Move Notion Pages to GitHub as Markdown

Export Notion as Markdown, strip the page IDs, fix the links, and commit the folder to a GitHub repository.

Direct answer

Export the pages as Markdown & CSV, then clean the zip in the Notion to Markdown tool's Clean export (.zip) mode. That removes the 32-character IDs from file names and rewrites the links to match. Leave Obsidian wiki links off, because GitHub uses standard Markdown links. Unzip the result into your repository, check the pages that had callouts, and commit.

Open the Notion export cleaner

When to use this

  • You want docs that lived in Notion to live next to the code.
  • You want your notes under version control instead of in one app.
  • You need plain .md files that any editor can open.

Steps

  1. In Notion, open the ••• menu at the top right of the page and pick Export. For the whole workspace, go to Settings, then General under Workspace, then Export all workspace content.
  2. Choose Markdown & CSV and turn on Include subpages.
  3. Upload the zip to Clean export (.zip) in the Notion to Markdown tool. Keep Obsidian wiki links off.
  4. Unzip the cleaned files into a folder in your repository, such as docs/. Images sit in the page folders next to the pages that use them.
  5. Commit, push, and click through a few pages on GitHub to check links and images.

Example

Before
docs/Onboarding 2e4f6a8c0b1d3e5f7a9c1b3d5e7f9a1c.md

Read [Setup](Onboarding%202e4f6a8c0b1d3e5f7a9c1b3d5e7f9a1c/Setup%204b6d8f0a2c4e6a8c0e2a4c6e8a0c2e4b.md) first.
After
docs/Onboarding.md

Read [Setup](Onboarding/Setup.md) first.

Common mistakes

  • Callouts export as raw HTML because Markdown has no callout. Review those blocks.
  • Some images can arrive as inline base64 data instead of files, which makes a page file large. Check the biggest .md files before you commit.
  • Pages you can't access, such as other members' private pages, are not in the export. Links to them won't resolve.

Tools for this job

FAQ

Do I need wiki links for GitHub?
No. Keep the wiki-link option off. [[Page]] links are Obsidian syntax and show up as plain text on GitHub.
Can I use the Notion API instead of an export?
Yes, for single pages. The API can return a page as Markdown with an integration token. It truncates very large pages, above about 20,000 blocks, and does not yet support bookmarks, embeds, or link previews in that format.
Will the repository stay in sync with Notion?
No. An export is a snapshot. Notion has no scheduled automatic backups, so you export again when you want a fresh copy.

Sources

Checked September 2026.

More guides for leaving Notion

Remove the Random Characters From Notion Export File Names

Why every file in a Notion export ends in a 32-character ID, and how to strip the IDs without breaking the links between pages.

How to Move From Notion to Obsidian

Use Obsidian's Importer plugin with a Notion API token or an HTML export. Clean a Markdown export here only as the fallback.

Turn a Notion Database CSV Into a Markdown Table

A Notion database exports as CSV plus one Markdown file per row. Here is how to get a readable Markdown table out of it.

How to Move a Notion Page to Google Docs

Export the page as Markdown, clean it, and paste it into Google Docs as rich text with headings, lists, links, and tables intact.

How to Move From Notion to Confluence

Use Confluence's official Notion importer for a whole workspace, or the Markdown route for a few pages. What each keeps and drops.

How to Move From Notion to Logseq

Logseq has no official Notion importer. Export Markdown, clean the names and links, and add the files to your graph.

Turn Your Notion Notes Into a Folder Claude Code Can Read

Export Notion as Markdown, clean the names, and add a short CLAUDE.md so Claude Code can find and use your notes.

Open-Source Notion Alternatives That Import Your Pages

AppFlowy, AFFiNE, Logseq, and Joplin compared by license and by which Notion export each one imports. Plus where Anytype and Obsidian fit.

Notion Export Not Working? Fixes for Common Errors

Fixes for Notion exports that hang, arrive as nested Part zips, expire, fail on Windows, or come back without attachments.