Skip to content
Exit Format

Move from Joplin to Obsidian

Best way: Same file format

Out of Joplin: Export as Markdown with front matter

  1. Go to File --> Export all --> MD - Markdown + Front Matter, or right-click a notebook or note and choose Export.
  2. Choose the folder to save it in.
  • The title, dates, tags, author, source URL, location and to-do details go in a YAML block at the top of each note.
  • Notebooks become folders, and every attachment goes in one _resources folder.
Official docs

Into Obsidian: Open or copy in a folder of Markdown files

  1. Select the vault profile at the bottom left --> Manage Vaults...
  2. Next to Open folder as vault, select Open and pick the folder.
  3. To add the notes to a vault you already use, drag them into the file explorer instead.
  • Files stay exactly as they are, so another app's own syntax won't be converted.
  • Other apps' databases, like Notion's CSV files, sit there as plain files rather than bases.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes, Tags, Properties and metadata, Created and updated dates, To-dos and reminders
Lost
Version history
Not sure

Another way: Same file format

Out of Joplin: Export as Markdown

  1. Go to File --> Export all --> MD - Markdown, or right-click a notebook or note and choose Export.
  2. Choose the folder to save it in.
  • Notebooks become folders, and every attachment goes in one _resources folder.
  • Notes written in HTML are saved as .html files.
  • Tags, dates and to-do details are left out. Use Markdown + Front Matter to keep them.
Official docs

Into Obsidian: Open or copy in a folder of Markdown files

  1. Select the vault profile at the bottom left --> Manage Vaults...
  2. Next to Open folder as vault, select Open and pick the folder.
  3. To add the notes to a vault you already use, drag them into the file explorer instead.
  • Files stay exactly as they are, so another app's own syntax won't be converted.
  • Other apps' databases, like Notion's CSV files, sit there as plain files rather than bases.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes
Lost
Tags, Properties and metadata, Created and updated dates, To-dos and reminders, Version history
Not sure

Another way: Same file format

Out of Joplin: Export as Markdown

  1. Go to File --> Export all --> MD - Markdown, or right-click a notebook or note and choose Export.
  2. Choose the folder to save it in.
  • Notebooks become folders, and every attachment goes in one _resources folder.
  • Notes written in HTML are saved as .html files.
  • Tags, dates and to-do details are left out. Use Markdown + Front Matter to keep them.
Official docs

Into Obsidian: Import Markdown files with Importer

  1. Install and enable the Importer plugin, then open it and pick Markdown (.md, .txt, .zip).
  2. Choose files, folders or a zip, set the options, then select Import.
  • A plain copy does the same job, unless you want a zip unpacked or inline tags turned into properties.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes
Lost
Tags, Properties and metadata, Created and updated dates, To-dos and reminders, Version history
Not sure

Another way: Same file format

Out of Joplin: Export as HTML

  1. Go to File --> Export all --> HTML - HTML Directory, or right-click a notebook or note and choose Export.
  2. Choose the folder to save it in.
  • Links between notes aren't rewritten, so they don't open the other exported pages.
Official docs

Into Obsidian: Import HTML files

  1. Install and enable the Importer plugin, then open it and pick HTML (.html, .zip).
  2. Choose HTML files, folders or zips and select Import.
  • If the app your pages came from has its own importer, use that instead. It keeps more.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure
Lost
Links between notes, Tags, Properties and metadata, Created and updated dates, To-dos and reminders, Version history
Not sure
Going the other way?

Other places Joplin can go

Other ways into Obsidian