Move from Microsoft OneNote to Joplin

Joplin has an importer made just for Microsoft OneNote, so it understands what Microsoft OneNote hands over.

Carries over 6
Note text
Formatting
Attachments and images
Page and folder structure
Links between notes
Created and updated dates
Lost 6
Sharing and permissions
App settings
Tags
To-dos and reminders
Version history
Embeds

How to move from Microsoft OneNote to Joplin

Export from Microsoft OneNote

Export a notebook from OneNote for the web
How
File
Needs
  • Personal Microsoft account
  1. In a browser, open OneNote for the web and right-click the notebook you want.
  2. Select Export notebook. The pop-up shows how big it is, so check you've got the space, then select Export.
  3. It downloads as a zip, with a folder named after the notebook inside.

Import into Joplin

Import from OneNote
How
File
Needs
  • Desktop app
  1. Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
  2. In Joplin, go to File, thenImport, thenONE - OneNote Notebook and choose the zip, .onepkg or .one file.

What to watch out for

Exporting from Microsoft OneNote

It only works for notebooks in a personal OneDrive, not a work or school one or SharePoint.

  • It's one notebook at a time. A download that stops when you run out of space has to start again, and one that's too big has to be split into smaller notebooks first.
  • If the zip only holds an errors.txt, the export failed, and that file says why.

Importing into Joplin

Pages come in as HTML notes, so they keep their layout rather than turning into Markdown.

  • Subpages land alongside their parent page, with the indents only kept in each section's index note.
  • OneNote's tags show up as icons in the note rather than Joplin tags, and To Do boxes are ticked or not but can't be clicked.
  • Handwriting and drawings come in as SVG images.

Where this comes from

Checked against the official docs on .

We work this route out from the Microsoft OneNote and Joplin entries, so if something's wrong, the fix goes in one of those.

Edit the Microsoft OneNote entry Edit the Joplin entry

Other ways to move from Microsoft OneNote to Joplin

2 more routes
Export OneNote files from OneNote for Windows , then Import from OneNote Built-in importer 6 carry over 6 lost 0 not sure
Carries over 6
Note text
Formatting
Attachments and images
Page and folder structure
Links between notes
Created and updated dates
Lost 6
Sharing and permissions
App settings
Tags
To-dos and reminders
Version history
Embeds

Export from Microsoft OneNote

Export OneNote files from OneNote for Windows
How
File
Needs
  • OneNote for Windows
  1. Open the notebook and go to File, thenExport.
  2. Under Export Current pick Notebook, then pick OneNote Package (*.onepkg) as the format and select Export.
  3. For a single section, pick Section and OneNote 2010-2016 Section instead.

Import into Joplin

Import from OneNote
How
File
Needs
  • Desktop app
  1. Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
  2. In Joplin, go to File, thenImport, thenONE - OneNote Notebook and choose the zip, .onepkg or .one file.

Exporting from Microsoft OneNote

Only the desktop app for Windows exports these, not OneNote for Mac, the web or the old OneNote for Windows 10.

  • Password-protected sections stay locked inside the file, and the apps that read it skip them. Take the password off first.

Importing into Joplin

Pages come in as HTML notes, so they keep their layout rather than turning into Markdown.

  • Subpages land alongside their parent page, with the indents only kept in each section's index note.
  • OneNote's tags show up as icons in the note rather than Joplin tags, and To Do boxes are ticked or not but can't be clicked.
  • Handwriting and drawings come in as SVG images.
Back up every notebook from OneNote for Windows , then Import from OneNote Built-in importer 6 carry over 6 lost 0 not sure
Carries over 6
Note text
Formatting
Attachments and images
Page and folder structure
Links between notes
Created and updated dates
Lost 6
Sharing and permissions
App settings
Tags
To-dos and reminders
Version history
Embeds

Export from Microsoft OneNote

Back up every notebook from OneNote for Windows
How
File
Needs
  • OneNote for Windows
  1. Go to File, thenOptions and choose Save & Backup.
  2. Select Back Up All Notebooks Now, then OK once it's done.
  3. The .one files are in the Backup Folder shown there, which starts out as %LOCALAPPDATA%\Microsoft\OneNote\16.0\Backup.

Import into Joplin

Import from OneNote
How
File
Needs
  • Desktop app
  1. Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
  2. In Joplin, go to File, thenImport, thenONE - OneNote Notebook and choose the zip, .onepkg or .one file.

Exporting from Microsoft OneNote

It takes every notebook in one go, rather than one at a time.

  • Password-protected sections stay locked in the backup too.

Importing into Joplin

Pages come in as HTML notes, so they keep their layout rather than turning into Markdown.

  • Subpages land alongside their parent page, with the indents only kept in each section's index note.
  • OneNote's tags show up as icons in the note rather than Joplin tags, and To Do boxes are ticked or not but can't be clicked.
  • Handwriting and drawings come in as SVG images.
  • Built-in importer
  • Same file format
  • Convert it first
  • Carries over
  • Lost
  • Not sure

Move from Joplin back to Microsoft OneNote

There's no way back from Joplin to Microsoft OneNote that we know of, so hang on to your Microsoft OneNote data until you're happy with the move.

Other places Microsoft OneNote can go

Other ways into Joplin