Skip to content Move from Obsidian to Joplin
Best way: Built-in importer
Out of Obsidian: Copy your vault folder
- Right-click a note and choose Reveal in Finder on a Mac, or Show in system explorer elsewhere.
- Go up to the top folder of your vault and copy the whole thing somewhere safe.
- 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
- Go to File --> Import --> OBSIDIAN - Obsidian Vault.
- 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
- Right-click a note and choose Reveal in Finder on a Mac, or Show in system explorer elsewhere.
- Go up to the top folder of your vault and copy the whole thing somewhere safe.
- 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
- Go to File --> Import and pick MD - Markdown + Front Matter, as a file or a directory.
- 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
- Right-click a note and choose Reveal in Finder on a Mac, or Show in system explorer elsewhere.
- Go up to the top folder of your vault and copy the whole thing somewhere safe.
- 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
- On desktop, go to File --> Import and pick MD - Markdown or TXT - Text document, as a file or a directory.
- On a phone, go to Configuration --> Import and Export and select Import from text file.
- 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