Skip to content
Exit Format

Move from Obsidian to Joplin

Best way: Built-in importer

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 Joplin: Import an Obsidian vault

  1. Go to File --> Import --> OBSIDIAN - Obsidian Vault.
  2. Choose the top folder of your vault.
  • Wikilinks become Joplin links when they match exactly one note. Links to a block (#^) stay as they are.
  • Inline #tags and the tags property both become Joplin tags.
  • Front matter is dropped, apart from cssclasses and the fields Joplin uses itself, like the title, dates and tags.
  • Embedded notes turn into plain links, and canvases and bases don't come across.
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes, Tags
Lost
Version history, Properties and metadata, Databases and views, Embeds, Canvases and whiteboards, Plugins and their data, App settings
Not sure
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 Joplin: Import Markdown with front matter

  1. Go to File --> Import and pick MD - Markdown + Front Matter, as a file or a directory.
  2. Choose the file or folder. Folders become notebooks.
  • It reads the title, dates, tags, author, source URL, location and to-do fields. Anything else in the front matter is dropped.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes, Tags
Lost
Version history, Properties and metadata, Databases and views, Embeds, Canvases and whiteboards, Plugins and their data, App settings
Not sure
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 Joplin: Import Markdown or text files

  1. On desktop, go to File --> Import and pick MD - Markdown or TXT - Text document, as a file or a directory.
  2. On a phone, go to Configuration --> Import and Export and select Import from text file.
  3. Choose the file or folder. Folders become notebooks.
  • Each note's title is its file name, and its dates come from the file.
  • Only relative Markdown links become note links. Wikilinks stay as text.
  • Front matter isn't read, it stays in the note as text. Use Markdown + Front Matter for that.
  • The phone app takes one file at a time.
Official docs
Carried
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes
Lost
Version history, Tags, Properties and metadata, Databases and views, Embeds, Canvases and whiteboards, Plugins and their data, App settings
Not sure
Created and updated dates
Going the other way?

Other places Obsidian can go

Other ways into Joplin