OneNote Md Exporter is a console application running on Windows that exports your OneNote notebooks in different markdown formats.
This tool is usefull to :
- evaluate or migrate to an alternative Knowledge Management Software like Joplin, Obsidian or other softwares based on Markdown format
- backup your OneNote Notebooks in an interoperable and open file format
- Windows >=10
- OneNote >= 2013, OneNote for Windows (from the Windows store) is not supported
- Word >= 2013
- Download the last release of OneNoteMdExporter from the Releases page
- Extract the content of the Zip archive
- Launch OneNote and be sure that notebooks to export are loaded
- Export your notebooks :
- Start
OneNoteMdExporter.exe
- Select the Notebook to export
- Select the export format
- [Optional] Edit advanced settings
- Go take a coffee ☕
- At the end of the export the export folder is open in Windows file explorer
- Start
Command line is supported, run OneNoteMdExporter.exe --help
for instructions.
- Sections and section groups are exported as a folder hierarchy containing pages :
Notebook1 - Section1 - Section1.1 - Page1.md - Page2.md - Section2
- Settings
ProcessingOfPageHierarchy
: page hierarchy as parent folder of md file (ParentPage\Child Page.md ; default value) or as md file prefix (ParentPage_ChildPage.md)ResourceFolderLocation
: images and file attachments can be stored in a single folder at the root of the export or in a folder next to each md fileAddFrontMatterHeader
: add a YAML header containing page metadata at the beginning of each md file--- title: Page title updated: 2021-11-11 14:55:00Z created: 2021-11-11 14:54:43Z --- Page content
PanDocMarkdownFormat
: choose the markdown syntax to use among those supported by pandoc. Use GitHub flavor by default.
- Import format of the Joplin app
- More details available here
Export format: | Markdown | Joplin |
---|---|---|
Hierarchy of sections | ✅ Folder hierarchy | ✅ Notebook hierarchy |
Page ordering inside a section | 🔴 Ordering based on md filename | ✅ |
Page hierarchy | ✅ Page prefix or folder prefix | ✅ |
All formats : | |
---|---|
Attachments | ✅ |
Image | ✅ |
Table | ✅ |
Image nexted into table | 🔴 Known issue #48 |
Font color | 🔴 |
Background color | 🟠 Highlighted text |
Drawing | 🟠 Flattened as image |
Handwriting | 🔴 Lost |
Text tags (task, star...) | 🔴 Lost |
Password protected sections | 🟠 Lost unless unlocked before export |
Folded paragraphs | 🔴 Lost |
Notebook internal link | 🔴 onenote:// url |
- DotNet 8 self-contained console application
- Export page as DocX and translate them in Markdown using PanDoc
- Offline : no call to Microsoft cloud
- Based on Office Interop APIs
- Apply some post-processing based on Regex to correct formatting issues
Released under the GPL, version 3.
This software carries no warranty of any kind. Some data can be lost during the export process. I recommend to review your notes after export and keep a backup of your OneNote notebooks just in case.
OneNote Md Exporter uses PanDoc universal markup converter.
Pandoc is available at https://github.com/jgm/pandoc
Pandoc is released under the following licence terms, full licence details can be found on the pandoc site.
© 2006-2021 John MacFarlane ([email protected]). Released under the GPL, version 2 or greater. This software carries no warranty of any kind.
- Install DotNet 8 : https://dotnet.microsoft.com/download/dotnet/8.0
- Clone this repository
- Extract
pandoc.exe
frompandoc-<Version>-windows-x86_64.zip
from/src/OneNoteMdExporter/pandoc/
folder - Build using Visual Studio 2019 or MSBUILD.exe (
dotnet build
do not currently support COMReference : https://aka.ms/msbuild/MSB4803)
Bugs and feature requests can be reported under: https://github.com/alxnbl/onenote-md-exporter/issues.
You can contribute by adding an new feature or add translations. See this page for more details.
I developed this tool on a voluntary basis, but if you like my work you can buy me a ☕.