Skip to content
Exit Format

Move from Obsidian to Notion

Best way: Same file format

Out of Obsidian: Copy your vault folder

  1. Right-click a note and choose Reveal in Finder on a Mac, or Show in system explorer elsewhere.
  2. Go up to the top folder of your vault and copy the whole thing somewhere safe.
  3. Skip the hidden .obsidian folder inside it unless you want your settings and plugins too.
  • Wikilinks, embeds, highlights and %%comments%% are Obsidian's own syntax, so other apps may show them as plain text.
  • Bases (.base files) only work in Obsidian, and canvases need an app that reads JSON Canvas.
  • Plugins only run in Obsidian, so anything they add to a note is just raw text anywhere else.
  • Sync's version history and File recovery snapshots aren't in the folder.
Official docs

Into Notion: Import a zip of documents

  1. Zip up the folder you want to bring in, so its folder structure comes along too.
  2. Go to Settings in the sidebar --> Import, or type /zip on a page.
  3. Upload the zip to Convert Zip to pages.
  • Each Markdown, text, HTML, Word, EPUB or OPML file becomes a page. Spreadsheets in the same zip become databases.
  • PDFs inside the zip are skipped.
  • Up to 5 GB a zip, though 10,000 files or more will probably fail.
  • Hidden files like .DS_Store can break it, so clear them out first.
Official docs
Carried
Note text, Formatting, Page and folder structure
Lost
Version history, Tags, Properties and metadata, Databases and views, Embeds, Canvases and whiteboards, Plugins and their data, App settings
Not sure
Attachments and images, Links between notes, Created and updated dates

Another way: Same file format

Out of Obsidian: Copy your vault folder

  1. Right-click a note and choose Reveal in Finder on a Mac, or Show in system explorer elsewhere.
  2. Go up to the top folder of your vault and copy the whole thing somewhere safe.
  3. Skip the hidden .obsidian folder inside it unless you want your settings and plugins too.
  • Wikilinks, embeds, highlights and %%comments%% are Obsidian's own syntax, so other apps may show them as plain text.
  • Bases (.base files) only work in Obsidian, and canvases need an app that reads JSON Canvas.
  • Plugins only run in Obsidian, so anything they add to a note is just raw text anywhere else.
  • Sync's version history and File recovery snapshots aren't in the folder.
Official docs

Into Notion: Import text and Markdown files

  1. Go to Settings in the sidebar --> Import --> Text & Markdown.
  2. Upload your .md or .txt files. You can pick several at once.
  • App-specific Markdown, like wikilinks or callouts, won't come across cleanly.
  • Links to headings inside a page don't carry over.
  • Loose files lose their folders. Zip the folder and use the zip import to keep them.
  • Files can be 5 MB each on the Free plan, 50 MB on paid ones.
Official docs
Carried
Note text, Formatting
Lost
Version history, Page and folder structure, Tags, Databases and views, Embeds, Canvases and whiteboards, Plugins and their data, App settings
Not sure
Attachments and images, Links between notes, Properties and metadata, Created and updated dates

Another way: Same file format

Out of Obsidian: Export a note to PDF

  1. Open the note, then pick Export to PDF... from the command palette or the More options menu.
  2. Choose the page size and margins, and whether to put the file name at the top as a title.
  3. Select Export to PDF and choose where to save it.
  • It works one note at a time.
  • Exports always use light styling, even if your theme is dark.
  • Phones and tablets got PDF export in v1.15, and some of the settings differ there.
Official docs

Into Notion: Import a PDF

  1. Go to Settings in the sidebar --> Import --> PDF, or type /pdf on a page and pick import.
  2. Upload one or more PDFs and Notion turns each into a page.
  • Headings, quotes and tables often need tidying afterwards, and colours are lost.
  • Scanned PDFs won't be searchable unless they've been through OCR first.
  • PDFs can be 5 MB on the Free plan, 20 MB on paid ones.
Official docs
Carried
Note text
Lost
Formatting
Not sure
Attachments and images, Links between notes, Properties and metadata
Going the other way?

Other places Obsidian can go

Other ways into Notion