{"id":13453994,"url":"https://github.com/alxnbl/onenote-md-exporter","last_synced_at":"2025-05-16T06:04:18.869Z","repository":{"id":44143916,"uuid":"330787213","full_name":"alxnbl/onenote-md-exporter","owner":"alxnbl","description":"ConsoleApp to export OneNote notebooks to Markdown formats","archived":false,"fork":false,"pushed_at":"2025-04-22T21:07:51.000Z","size":181612,"stargazers_count":1075,"open_issues_count":17,"forks_count":89,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-05-16T06:03:20.729Z","etag":null,"topics":["evernote","joplin","markdown","obsidian","onenote","pandoc"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alxnbl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-01-18T21:07:39.000Z","updated_at":"2025-05-16T02:24:06.000Z","dependencies_parsed_at":"2025-05-16T06:03:28.636Z","dependency_job_id":null,"html_url":"https://github.com/alxnbl/onenote-md-exporter","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alxnbl%2Fonenote-md-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alxnbl%2Fonenote-md-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alxnbl%2Fonenote-md-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alxnbl%2Fonenote-md-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alxnbl","download_url":"https://codeload.github.com/alxnbl/onenote-md-exporter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478186,"owners_count":22077675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["evernote","joplin","markdown","obsidian","onenote","pandoc"],"created_at":"2024-07-31T08:00:50.159Z","updated_at":"2025-05-16T06:04:18.813Z","avatar_url":"https://github.com/alxnbl.png","language":"C#","funding_links":["https://www.buymeacoffee.com/alxnbl"],"categories":["C# #","Dendron Enhancers","C\\#"],"sub_categories":["Migration tools"],"readme":"**OneNote Md Exporter** is a console application running on Windows that exports your OneNote notebooks in different markdown formats.\n\nThis tool is usefull to :\n* evaluate or migrate to an alternative Knowledge Management Software like Joplin, Obsidian or other softwares based on Markdown format\n* backup your OneNote Notebooks in an interoperable and open file format\n\nThe tool is easy to install and use, and generally produces better results than other OneNote export methods.\n\n# Requirements\n\n- Windows \u003e=10\n- OneNote \u003e= 2013, OneNote for Windows (from the Windows store) is not supported\n- Word \u003e= 2013\n\n# Getting started\n\n1. Download the last release of OneNoteMdExporter from the [Releases page](https://github.com/alxnbl/onenote-md-exporter/releases)\n2. Extract the content of the Zip archive\n3. Launch OneNote and be sure that notebooks to export are loaded\n4. Export your notebooks :\n   * Start `OneNoteMdExporter.exe`\n   * Select the Notebook to export\n   * Select the export format\n   * [Optional] Edit advanced settings\n   * Go take a coffee ☕\n   * At the end of the export the export folder is open in Windows file explorer\n\nCommand line is supported, run `OneNoteMdExporter.exe --help` for instructions.\n\n# Export formats supported\n\n## Markdown\n\n* Sections and section groups are exported as a folder hierarchy containing pages :\n   ```yaml\n   Notebook1\n   - Section1\n     - Section1.1\n       - Page1.md\n       - Page2.md\n   - Section2\n   ```\n* Settings\n  * `ProcessingOfPageHierarchy` : page hierarchy as parent folder of md file (ParentPage\\Child Page.md ; default value) or as md file prefix (ParentPage_ChildPage.md)\n  * `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 file\n  * `AddFrontMatterHeader` : add a YAML header containing page metadata at the beginning of each md file\n    ```yaml\n    ---\n    title: Page title\n    updated: 2021-11-11 14:55:00Z\n    created: 2021-11-11 14:54:43Z\n    ---\n    Page content\n    ```\n  * `PanDocMarkdownFormat` : choose the markdown syntax to use among [those supported by pandoc](https://pandoc.org/MANUAL.html#general-options). Use *GitHub flavor* by default.\n\n## Joplin Raw Directory\n\n* Import format of the  [Joplin](https://github.com/laurent22/joplin) app\n* More details [available here](/doc/migration-to-joplin.md)\n\n# Features and limitations\n\n| Export format: | Markdown | Joplin |\n| --- | --- | --- |\n| Hierarchy of sections | ✅ Folder hierarchy | ✅ Notebook hierarchy |\n| Page ordering inside a section | 🔴 Ordering based on md filename | ✅ |\n| Page hierarchy | ✅ Page prefix or folder prefix | ✅ |\n\n\n___\n___\n\n| All formats : |  |\n| --- | --- |\n| Attachments  | ✅ |\n| Image  | ✅ |\n| Table  | ✅ |\n| Folded paragraphs | ✅ |\n| Image nexted into table | 🔴 Known issue [#48](https://github.com/alxnbl/onenote-md-exporter/issues/48) |\n| Font color| 🔴 |\n| Background color  | 🟠 Highlighted text |\n| Drawing | 🟠 Flattened as image | \n| Handwriting  | 🔴 Lost |\n| Text tags (task, star...)  | 🔴 Lost |\n| Password protected sections | 🟠 Lost unless unlocked before export |\n| Notebook internal link | 🔴 onenote:// url |\n\n# Technical characteristics\n\n* DotNet 8 self-contained console application\n* Export page as DocX and translate them in Markdown using PanDoc\n* Offline : no call to Microsoft cloud\n* Based on Office Interop APIs\n* Pre-processing stage of OneNote page XML structure\n* Post-processing stage based on Regex to fix formatting issues\n\n# Licence\n\nReleased under the GPL, version 3.\n\nThis 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.\n\n## Pandoc licence terms\n\nOneNote Md Exporter uses PanDoc universal markup converter.\n\nPandoc is available at https://github.com/jgm/pandoc\n\nPandoc is released under the following licence terms, full licence details can be found on the pandoc site.\n\n\u003e © 2006-2021 John MacFarlane (jgm@berkeley.edu). Released under the GPL, version 2 or greater. This software carries no warranty of any kind.\n\n\n# Build sources\n\n* Install DotNet 8 : https://dotnet.microsoft.com/download/dotnet/8.0\n* Clone this repository\n* Extract `pandoc.exe` from `pandoc-\u003cVersion\u003e-windows-x86_64.zip` from `/src/OneNoteMdExporter/pandoc/` folder\n* Build using Visual Studio 2019 or MSBUILD.exe (`dotnet build` do not currently support COMReference : https://aka.ms/msbuild/MSB4803) \n\n# Contribute\n\nBugs and feature requests can be reported under: https://github.com/alxnbl/onenote-md-exporter/issues.\n\nYou can contribute by adding an new feature or add translations. See [this page](/doc/contribute.md) for more details.\n\n# Support\n\nI developed this tool on a voluntary basis, but if you like my work you can [buy me a ☕](https://www.buymeacoffee.com/alxnbl).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falxnbl%2Fonenote-md-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falxnbl%2Fonenote-md-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falxnbl%2Fonenote-md-exporter/lists"}