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- In a browser, open OneNote for the web and right-click the notebook you want.
- Select Export notebook. The pop-up shows how big it is, so check you've got the space, then select Export.
- It downloads as a zip, with a folder named after the notebook inside.
Import into Joplin
Import from OneNote- Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
- 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
Exporting from Microsoft OneNote
Importing into Joplin
- Official docs joplinapp.org/help/apps/import_export
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService_Importer_OneNote.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/lib.rs
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/page/note_tag.rs
- Evidence github.com/laurent22/joplin/pull/14094
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.
Other ways to move from Microsoft OneNote to Joplin
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- Open the notebook and go to File, thenExport.
- Under Export Current pick Notebook, then pick OneNote Package (*.onepkg) as the format and select Export.
- For a single section, pick Section and OneNote 2010-2016 Section instead.
Import into Joplin
Import from OneNote- Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
- 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.
- Official docs support.microsoft.com/en-us/onenote/onenote-help-and-learning/export-notes-from-onenote-as-a-pdf
- Evidence github.com/obsidianmd/obsidian-help/blob/ced32050c0d9d1e1f8d3faa19a8ba8474d75a32d/en/Import%20notes/Import%20from%20Microsoft%20OneNote.md
- Evidence learn.microsoft.com/en-us/openspecs/office_file_formats/ms-onestore/ae670cd2-4b38-4b24-82d1-87cfb2cc3725
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.
- Official docs joplinapp.org/help/apps/import_export
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService_Importer_OneNote.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/lib.rs
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/page/note_tag.rs
- Evidence github.com/laurent22/joplin/pull/14094
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- Go to File, thenOptions and choose Save & Backup.
- Select Back Up All Notebooks Now, then OK once it's done.
- 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- Export a notebook from OneNote for the web, or a notebook or section from OneNote for Windows.
- 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.
- Official docs joplinapp.org/help/apps/import_export
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/lib/services/interop/InteropService_Importer_OneNote.ts
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/lib.rs
- Evidence github.com/laurent22/joplin/blob/v3.7.24/packages/onenote-converter/renderer/src/page/note_tag.rs
- Evidence github.com/laurent22/joplin/pull/14094
- 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
- Move from Microsoft OneNote to Obsidian Built-in importer 9 carry over 2 lost 0 not sure
Other ways into Joplin
- Move from Evernote to Joplin Built-in importer 8 carry over 4 lost 0 not sure
- Move from Obsidian to Joplin Built-in importer 6 carry over 7 lost 1 not sure