OneNote导出Markdown完整教程onenote-md-exporter从入门到精通【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter本文是一份关于 OneNote 转 Markdown 的完整操作指南详细介绍开源工具 onenote-md-exporter 的安装步骤、首次导出流程、进阶配置策略与常见问题排查帮助你把 OneNote 笔记本无损迁移到 Obsidian、Joplin 等现代笔记平台。周一早上老张对着屏幕发呆。公司要求把团队三年的 OneNote 项目文档迁到 Obsidian他试过复制粘贴——表格全散架几百个页面成了扁平的一堆文件试过在线转换工具——文档传到别人的服务器合规部门第一个不答应。折腾两天进度为零。这个场景你可能不陌生。OneNote 的数据锁定在自己的格式里分区、页面层级、内部链接、图片附件哪一样都让人头疼。这篇文章围绕一个免费开源工具onenote-md-exporter一款在 Windows 上运行的命令行程序能把 OneNote 笔记本批量导出为 Markdown讲透整条迁移路径从安装到进阶配置一次讲完。为什么 OneNote 迁移这么麻烦先看清问题出在哪格式封闭OneNote 的页面内容存放在私有数据库中普通工具读不出来。层级复杂笔记本→分区组→分区→父页面→子页面五层结构在导出时很容易被压扁。内部链接页面间用onenote://协议互相引用换平台后全部变成死链。资源分散图片、附件内嵌在页面 XML 里手动导出必然丢位置。手动方案复制粘贴、PDF 批量打印、ENEX 中转各有各的坑。而 onenote-md-exporter 走的是另一条路直接调用 OneNote 和 Word 的官方 COM 接口提取原始内容再交给Pandoc业界标准的文档格式转换引擎完成 DocX 到 Markdown 的转换全程在本地运行不上传任何数据。三步完成安装与首次导出前置条件缺一不可Windows 10 及以上系统OneNote 2013 及以上版本商店版不支持Microsoft Word 2013 及以上版本.NET 运行时环境第一步获取程序git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter也可以直接下载发布包解压得到OneNoteMdExporter.exe。第二步准备 OneNote先启动 OneNote确认要导出的笔记本已经完整加载并完成同步。这一步很关键漏掉它会出现导出后图片丢失的后续麻烦。第三步运行导出双击OneNoteMdExporter.exe按提示操作从列表中选择笔记本输入 0 代表导出全部选择导出格式1为 Markdown2为 Joplin 专用格式询问是否修改配置时输入y会用记事本打开appSettings.json首次使用建议保持默认去喝杯咖啡 ☕等待期间程序会逐页转换导出完成后自动打开输出文件夹。命令行模式适合批量场景核心参数如下# 导出指定笔记本为 Markdown OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --output D:\笔记备份 # 导出全部笔记本为 Joplin 格式 OneNoteMdExporter.exe --all-notebooks --format 2 --no-input常用参数--section指定分区、--page指定页面、--ignore-errors跳过出错页面继续导出、--debug开启调试日志。完整说明运行OneNoteMdExporter.exe --help查看。链接处理策略怎么选OneNote 内部链接的转换是迁移后知识网络能否复活的胜负手。程序通过OneNoteLinksHandling参数提供四种策略策略输出示例适合人群优点缺点KeepOriginalonenote://...还要回迁 OneNote 的用户原始链接完整保留其他平台打不开ConvertToMarkdown文字Joplin、Typora 用户标准 Markdown兼容性好路径带空格需转义ConvertToWikilink[[页面标题\|文字]]Obsidian、Logseq 用户双链笔记原生支持仅限特定平台Remove仅保留文字想彻底清理旧链接输出干净无杂质链接关系丢失配置在 src/OneNoteMdExporter/appSettings.json 中修改保存后重新运行即可生效。三种典型场景的配置方案场景一Obsidian 双链笔记迁移Obsidian 最大的价值是双链和知识图谱配置要往保持结构、生成双链上靠{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: PageParentFolder, OneNoteLinksHandling: ConvertToWikilink, AddFrontMatterHeader: true, UseHtmlStyling: true }HierarchyAsFolderTree会把父子页面还原成文件夹嵌套图片跟随页面存放方便整个文件夹拖进 Obsidian 库。开启AddFrontMatterHeader后每页开头会生成包含创建时间、更新时间的 YAML 元数据头Obsidian 可以据此做时间线视图。场景二Joplin 平台迁移Joplin 有自己的导入格式选择2Joplin Raw Directory导出后在 Joplin 中执行文件 导入 RAW - Joplin 导出目录即可。相比先转 ENEX 再导入的传统路线这种直连方式能保住分区层级和页面顺序详细对比见 doc/migration-to-joplin.md。{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: ConvertToMarkdown, PanDocMarkdownFormat: gfm }资源统一放在根目录resources文件夹Joplin 导入后会自动识别。场景三通用 Markdown 归档只想把笔记变成永久可读的开放格式追求最小依赖{ ProcessingOfPageHierarchy: IgnoreHierarchy, OneNoteLinksHandling: Remove, AddFrontMatterHeader: false, UseHtmlStyling: false }IgnoreHierarchy忽略页面层级所有页面平铺在分区目录下UseHtmlStyling关闭后字体颜色、背景色不再生成 HTML 标签输出更纯净。三种方案横向对比对比项Obsidian 方案Joplin 方案归档方案适用人群双链笔记重度用户Joplin 用户通用 Markdown 用户页面层级文件夹树文件夹树平铺链接形式双链标准链接移除资源位置页面旁根目录集中根目录集中学习成本中低低最常见的报错及解法报错一COMException 初始化失败Unhandled exception. System.Runtime.InteropServices.COMException程序无法与 OneNote 通信。按顺序排查确认 OneNote 已启动并登录 Microsoft 账户以管理员身份运行命令提示符再执行程序检查 Office 安装完整性必要时修复换台电脑试在 OneNote 中文件 导出 笔记本 OneNote 包把生成的.onepkg文件在另一台电脑导入后导出流程见 doc/notebook-onepkg-export.md。报错二导出后图片大量丢失多数是同步未完成。在 OneNote 中打开文件 选项 同步勾选下载所有文件和图像强制同步后再导出。也可以在配置里把KeepOneNoteTempFiles设为true保留中间 DocX 文件便于定位是哪一步丢的。报错三文件名过长导致路径错误页面标题动辄七八十字文件系统路径会超限。调低配置里的PageTitleMaxLength和MdMaxFileLength默认都是 50标题超出部分会被自动截断。导出质量能到什么程度从功能支持表看完整清单见项目 README大部分常用元素都有保障内容类型支持情况简单表格✅ 转成 Markdown 表格复杂表格、字体颜色、背景色✅ 转成 HTML 标签编辑器需支持 HTML文本标签任务、星标等✅ 转为 emoji 表情绘图内容⚠️ 扁平化为图片手写笔迹❌ 丢失密码保护分区⚠️ 需提前解锁需要注意跨笔记本链接和指向分区的链接会被移除UseHtmlStyling开启时高亮不会转成语法。这些都是有意的取舍导出后花几分钟抽查几个复杂页面即可。与生态工具协同的完整工作流Obsidian按场景一导出后把文件夹复制进库目录刷新即可。双链会自动生成配合图谱视图可以重建知识网络。Joplin按场景二导出用 RAW 导入功能完成迁移。批量自动化在 PowerShell 中循环调用--all-notebooks配合--ignore-errors即可实现无人值守的定期备份。长期归档Markdown 是纯文本开放格式任何编辑器都能打开50 年后依然可读这是 OneNote 私有格式给不了的保障。收尾三条核心结论与下一步行动本地处理、隐私无忧数据全程不离开电脑不依赖微软云服务适合企业文档迁移。结构保留是最大卖点分区层级、页面父子关系、内部链接都有对应的处理策略这是复制粘贴和 ENEX 中转做不到的。配置决定体验动手前先想清楚目标平台对照上文三套配置选择能省下大量返工时间。建议的行动路径先备份 OneNote 原始数据务必再用一个测试笔记本跑通全流程确认输出质量后再对全量数据执行迁移。迁移完成不等于结束——记得在 Obsidian 或 Joplin 里逐个抽查链接和图片把工具生成的 emoji 标签整理成自己的标签体系。选一个周末下午备份好数据开始你的第一次导出实验。你会发现把知识从 OneNote 里解放出来比想象中简单。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考