Joplin vs OneNote: Switching Without Losing Notes
Yes, you can switch from OneNote to Joplin without losing your notes. Joplin has a built-in OneNote importer that converts notebooks, sections, and pages into Joplin’s Markdown-based format, and you can export everything from OneNote first to make the process smoother. This article explains exactly how the import works, what you might lose, and how to handle common problems so years of accumulated notes don’t hold you back.
Why People Switch from OneNote to Joplin
OneNote is free, widely used, and deeply integrated with Windows and Microsoft 365. But it has limitations that push people toward open-source alternatives. Joplin is a free, open-source note-taking app that stores everything locally as plain Markdown files, which means your notes are never locked into a proprietary format. You can sync them with your own cloud service (Nextcloud, Dropbox, OneDrive, or a WebDAV server) rather than being forced into Microsoft’s ecosystem. Joplin also offers end-to-end encryption for sync, which OneNote does not provide by default. For users who value data ownership, cross-platform consistency (Windows, macOS, Linux, Android, iOS), or who simply want a lighter, faster app, Joplin is a compelling choice.
How Joplin’s OneNote Importer Works
Joplin includes a dedicated OneNote importer that runs inside the desktop app. It does not connect directly to Microsoft’s servers; instead, it reads an exported OneNote file. The process has two main steps:
- Export from OneNote: In the OneNote desktop app (Windows), go to File > Export, choose Notebook as the export type, and select OneNote Package (*.onepkg) as the format. This creates a single file containing the entire notebook.
- Import into Joplin: In Joplin, go to File > Import > OneNote (.onepkg), select the exported file, and Joplin converts it into a new notebook structure.
The importer preserves the notebook hierarchy, section groups, and page order. It converts each OneNote page into a Joplin note with the page title as the note title and the page content as Markdown. Images, attachments, and embedded files are extracted and saved as local resources, which Joplin links to from the note body.
What Gets Lost or Changed in the Conversion
No importer is perfect, and you should expect some differences. The most common issues are:
- Complex formatting: OneNote’s rich text (tables, colored fonts, highlighting, and inline styles) is simplified to Markdown. Tables become Markdown tables, but merged cells or complex layouts may not survive intact.
- Handwritten notes and ink: OneNote’s drawing and handwriting features do not convert. Ink strokes are typically dropped, leaving only the text that was typed alongside them.
- Embedded audio/video: Audio recordings and video clips embedded in OneNote pages may not be extracted as playable files. They might appear as broken links or be omitted entirely.
- Page tags: OneNote’s custom tags (like “To Do” or “Important”) are not mapped to Joplin’s tagging system. You’ll need to re-add them manually.
- Links between pages: Internal links between OneNote pages are converted to plain text or may break, because Joplin uses a different note ID system.
For most text-based notes, the conversion is clean. For heavily formatted or media-rich pages, expect to spend time cleaning up after import.
Step-by-Step: Export from OneNote and Import to Joplin
Here is the exact workflow for a typical Windows user:
- Open OneNote (the classic desktop app, not the Windows 10/11 Store version). If you only have the Store version, install the classic OneNote from Microsoft’s website – it’s free and still supported.
- Click File > Export. Under Export Current, choose Notebook. Then select OneNote Package (*.onepkg) and click Export.
- Choose a destination folder and save the .onepkg file. Repeat for each notebook you want to move.
- Open Joplin on your desktop. Go to File > Import > OneNote (.onepkg).
- Select the .onepkg file. Joplin will show a progress bar and then create a notebook named after your OneNote notebook.
- After import, open a few pages to check formatting. Fix any broken images or links manually.
- Repeat for each notebook. Once you’re satisfied, you can sync Joplin to your preferred cloud service via Tools > Options > Synchronisation.
If the import fails or produces errors, try exporting each section individually instead of the whole notebook. OneNote’s export also allows Section (*.one) files, which Joplin can import as well, though the .onepkg route is usually more complete.
Common Problems and How to Fix Them
Users often hit a few snags during migration. Here are the most frequent issues and their solutions:
- Import error: “Invalid file format” – This usually means the .onepkg file is corrupt or was not fully downloaded. Re-export from OneNote and try again. Also ensure you’re using the latest Joplin version.
- Images missing after import – Sometimes images are stored in OneNote’s cache but not in the export. Open the original page in OneNote, copy the image, and paste it into the Joplin note manually.
- Notebook hierarchy flattened – If your OneNote notebook had section groups (folders within folders), the importer may flatten them into a single level. You can reorganize by dragging notes into new notebooks in Joplin’s sidebar.
- Very large notebooks take a long time – A notebook with thousands of pages can take several minutes to import. Be patient, and don’t close Joplin during the process. If it crashes, try importing sections one at a time.
- Special characters in filenames – Joplin uses note titles as filenames in its local storage. Characters like
\ / : * ? " < > |are not allowed in Windows filenames. The importer renames these pages, but you may need to manually rename them afterward to keep your original titles.
Alternatives to Joplin’s Importer
If the built-in importer doesn’t work for you, there are other routes:
- Export to Word/HTML and import: OneNote can export a page as a Word document (.docx) or HTML file. Joplin can import Markdown, HTML, and plain text, but not .docx directly. You’d need to convert the Word file to Markdown using a third-party tool like Pandoc, then import that into Joplin.
- Use a third-party migration tool: Some open-source scripts (like the “onenote-to-joplin” Python script) attempt to parse OneNote’s internal format directly. These are unofficial and may not work with newer OneNote versions, but they can be useful for specific cases.
- Manual copy-paste: For a small number of critical notes, copying and pasting from OneNote to Joplin preserves formatting better than the importer. It’s tedious for hundreds of notes, but reliable for a few.
The built-in importer is the easiest starting point. Try it first, and only fall back to these alternatives if you encounter data loss that matters to you.
Costs and Privacy Considerations
Joplin is completely free and open-source (MIT license). There are no premium tiers or subscription fees. You only pay for the cloud storage you choose for syncing, if you use it. OneNote is also free, but it stores your notes on Microsoft’s servers by default. With Joplin, your notes stay on your device unless you set up sync. You can sync via your own Nextcloud instance, a WebDAV server, or a cloud provider like Dropbox or OneDrive – you control where the data goes. Joplin also supports end-to-end encryption for sync, so even if you use a third-party server, no one but you can read the notes. This is a significant privacy advantage over OneNote, which does not offer E2EE.
Frequently Asked Questions
Will my OneNote notebooks import into Joplin with the same structure?
Mostly yes. Joplin’s importer recreates notebooks, section groups, and pages in the same hierarchy. However, if you have deeply nested section groups, they may be flattened into a single level. You can manually reorganize them after import.
Can I import from OneNote for Mac or the web version?
The .onepkg export is only available in the Windows desktop app. If you use OneNote on Mac or the web, you can still export pages as PDF or Word, but you’ll lose the notebook structure. A practical workaround is to open your notebook in the Windows desktop app (it’s free) and export from there.
What about my handwritten notes and drawings?
These do not convert. Joplin is text-focused and does not support ink input. If you have important handwritten content, you’ll need to screenshot it as an image and insert it into a Joplin note, or keep those pages in OneNote.
Will my tags and searchable text come over?
Text content is fully searchable in Joplin, and the importer does a good job of preserving the text. However, OneNote’s custom tags (like “To Do” or “Important”) are not converted to Joplin tags. You’ll need to re-add them manually, or use Joplin’s built-in to-do checkboxes instead.
Is there a way to test the import without committing?
Yes. Export a single section from OneNote (as a .one file) and import that into Joplin first. This gives you a small sample to check formatting and identify issues before you import your entire notebook.
Can I keep using OneNote while I test Joplin?
Absolutely. Joplin and OneNote can run side by side. Import a copy of your notes into Joplin, try it for a few weeks, and only delete your OneNote notebooks once you’re confident Joplin works for you. The import doesn’t modify your OneNote data.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.