Skip to content
Exit Format

Export your data from Joplin

Free, open source notes and to-dos in Markdown, kept on your devices and synced through Joplin Cloud or a cloud of your choice.

On your device, Windows, macOS, Linux, Android, iOS

Website Source code

Getting it out

Export a JEX file or RAW folder

File

  1. On desktop, go to File --> Export all and pick JEX - Joplin Export File or RAW - Joplin Export Directory.
  2. To save just one notebook or note, right-click it and choose Export instead.
  3. On a phone, go to Configuration --> Import and Export and select Export all notes as JEX.
Included
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
Missing
Version history, Plugins and their data, App settings
Not sure
  • The export isn't encrypted, even if your sync is.
  • Notes this device hasn't decrypted yet get left out, with a warning.
Official docs SourceSource

Export as Markdown

File

Needs Desktop or terminal app

  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.
Included
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes
Missing
Tags, Properties and metadata, Created and updated dates, To-dos and reminders, Version history
Not sure
  • 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 Source

Export as Markdown with front matter

File

Needs Desktop or terminal app

  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.
Included
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
Missing
Version history
Not sure
  • 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 Source

Export as HTML

File

Needs Desktop or terminal app

  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.
Included
Note text, Formatting, Attachments and images, Page and folder structure
Missing
Links between notes, Tags, Properties and metadata, Created and updated dates, To-dos and reminders, Version history
Not sure
  • Links between notes aren't rewritten, so they don't open the other exported pages.
Official docs Source

Export notes as PDF

File

Needs Desktop app

  1. Select the notes you want, then go to File --> Export all --> PDF - PDF File.
  2. Pick a file name, or a folder if you selected more than one note.
Included
Note text, Formatting
Missing
Not sure
Attachments and images
  • Despite sitting under Export all, it only exports the notes you've selected, one PDF each.
Official docs Source

Bringing it in

Import a JEX file or RAW folder

File

  1. On desktop, go to File --> Import and pick JEX - Joplin Export File or RAW - Joplin Export Directory.
  2. On a phone, go to Configuration --> Import and Export and select Import from JEX.
  3. Choose the file or folder.
  • Everything comes in as new copies, so importing the same file twice gives you duplicates.
Official docs Source

Import an Obsidian vault

Folder

Built for

Needs Joplin 3.7.16 or later, Desktop or terminal app

  1. Go to File --> Import --> OBSIDIAN - Obsidian Vault.
  2. Choose the top folder of your vault.
Included
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes, Tags, Created and updated dates
Missing
Properties and metadata, Embeds, Canvases and whiteboards, Databases and views, Plugins and their data, App settings
Not sure
  • 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.
SourceSourceSource

Import Markdown or text files

File

  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.
Included
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes
Missing
Tags, Properties and metadata, Databases and views
Not sure
  • 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 Source

Import Markdown with front matter

File

Needs Desktop or terminal app

  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.
Included
Note text, Formatting, Attachments and images, Page and folder structure, Links between notes, Tags, Created and updated dates, To-dos and reminders
Missing
Not sure
  • It reads the title, dates, tags, author, source URL, location and to-do fields. Anything else in the front matter is dropped.
Official docs Source

Import HTML files

File

Needs Desktop or terminal app

  1. Go to File --> Import and pick HTML - HTML document, as a file or a directory.
  2. Choose the file or folder. Folders become notebooks.
  • Notes stay as HTML rather than being turned into Markdown.
Official docs Source

Import from Evernote

File

Needs Desktop or terminal app

  1. In Evernote, export your notebooks as ENEX files.
  2. In Joplin, go to File --> Import and pick ENEX - Evernote Export File, as Markdown or as HTML.
  3. Choose one .enex file, or a folder of them to get a notebook per file.
  • As Markdown, colours, fonts and font sizes are dropped. Import as HTML to keep them.
  • Links between notes are matched by title, so a few may still point at Evernote.
  • Evernote's recognised text in images isn't kept, though Joplin's own OCR can redo it.
Official docs

Import from OneNote

File

Needs Desktop app

  1. Export a section or notebook from OneNote for Windows, or download the notebook's folder from OneDrive as a zip.
  2. In Joplin, go to File --> Import --> ONE - OneNote Notebook and choose the file.
  • .onepkg files only import when Joplin's running on Windows.
  • OneDrive may not hand over notebooks bigger than 2-4 GB in one go.
Official docs Source

Move to

Bring in from

Delete your data

  1. To clear Joplin Cloud now, delete your notes and notebooks in the app, then sync.
  2. Open your Joplin Cloud profile, scroll down and select Manage subscription to cancel it.
  3. Leave it there - Joplin Cloud deletes a cancelled account by itself, 99 days after it's disabled.

Only matters if you sync with Joplin Cloud. Notes on your own devices, or on another sync target, are yours to clear.

Joplin Cloud's help says it won't delete data on request, though its privacy policy says to email support@joplincloud.com. Deleting and syncing is quicker either way.

Official docs