OneNote 导出 Markdown 完整指南800 篇笔记迁移从三个周末缩成一条命令【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter方澄是一家创业公司的文档负责人接手了前任留下的知识遗产四年、800 多篇 OneNote 笔记里面是产品需求、客户会议纪要和一堆踩坑记录。公司决定统一用 Obsidian 建知识库OneNote 导出的活儿全压给了他。他先试了复制粘贴两个周末搭进去表格散成乱码、图片路径全断又试 OneNote 自带的导出功能800 篇页面倒是全出来了却齐刷刷平铺进同一个文件夹分区层级消失得干干净净内部链接全部失效。前前后后烧掉三十多个小时颗粒无收。直到有人丢给他一个本地命令行工具onenote-md-exporter——它直接调用本机 OneNote 读取原稿把笔记本完整导出为 Markdown层级、附件、内部链接一条不落。先看能力边界哪些能完整保留哪些注定丢失这个工具不是万能转换器动手前先对齐预期。它能完整保留分区与分区组的嵌套目录、页面之间的父子关系图片和附件统一收进resources文件夹简单表格转成 Markdown 表格复杂表格以 HTML 形式保留内部链接可以自动转成[[双链]]或 Markdown 链接。但手写笔迹不支持转换密码保护的分区不解锁会整个丢失跨笔记本链接会被移除绘图会压平成图片。边界清楚才不会被导出即完美的错觉坑到。和常见方案对比差距一目了然迁移方式层级结构内部链接图片附件数据去向手工复制粘贴全部丢失全部失效丢失本地OneNote 自带导出拍平成一堆文件失效基本可用本地在线转换网站拍平失效看运气需上传云端onenote-md-exporter完整保留转为双链完整保留全程本地导出前必做的原理速览与环境检查为什么它转出来比别家靠谱你可以把它想象成一条三条工序的流水线第一站OneNote 本人照着原稿誊写每页生成一份 DocX 底稿第二站专职译员 Pandoc 把 DocX 翻成 Markdown第三站一段正则脚本当校对员逐条修平格式毛刺。三道工序都在本机完成不碰任何云端。跑之前对照这份清单自查Windows 10 及以上系统OneNote 2013 及以上注意微软商店版不支持Word 2013 及以上目标笔记本已在 OneNote 中打开并完成同步pandoc.exe已解压到程序所在文件夹我第一回就漏了这步结果转换引擎缺失报错有密码保护的分区先手动解锁。完整导出一份笔记本四步照着做就行第一步拿到工具。在命令行里克隆仓库git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter第二步补齐转换引擎。进入src/OneNoteMdExporter/pandoc/目录把里面的 pandoc 压缩包解压让pandoc.exe和程序待在同一个文件夹里。第三步让 OneNote 就位。打开 OneNote确认要导出的笔记本已经加载、同步完成。工具读的是实时状态笔记本没打开后面全是空。第四步启动导出。最省心的方式是双击运行OneNoteMdExporter.exe它会列出本机所有笔记本你勾选目标、选格式、按需调整高级设置跑完自动弹出导出文件夹。想做批量无人值守先跑一句OneNoteMdExporter.exe --help看看全部参数再带上笔记本名称和格式编号一次跑完想整机全导也有对应的全部笔记本开关会逐个处理不用你盯着。导出后你会得到和 OneNote 里几乎一一对应的文件夹树分区是目录分区组是嵌套子目录子页面挂在父页面下面。图片和附件统一收在resourcesMarkdown 内部用相对路径引用丢进 Obsidian 仓库就能直接用。第一次运行报错怎么处理高频坑自查清单启动时报无法连接 OneNote 组件通常是本机 Office 安装有问题重装代价太大。最省事的解法按 doc/notebook-onepkg-export.md 把笔记本导出成.onepkg包换台干净电脑导入后再转 Markdown效果一样风险更低。导出后图片是坏的多半是本地根本没缓存图片。到「文件 → 选项 → 同步」勾上下载所有文件和图像强制同步一次再重新导出。密码分区变成空目录锁着的分区不会进入结果导出前逐个解锁。文件名过长导致路径超限在配置里把MdMaxFileLength调小从源头绕开 Windows 路径上限。进阶技巧给 Obsidian 与 Joplin 的推荐配置投奔 Obsidian把appSettings.json里的OneNoteLinksHandling设为ConvertToWikilink内部链接直接变成[[双链]]AddFrontMatterHeader保持true每篇自动带上创建/更新时间方便日后检索页面层级保持文件夹树即可。{ OneNoteLinksHandling: ConvertToWikilink, AddFrontMatterHeader: true, ProcessingOfPageHierarchy: HierarchyAsFolderTree }投奔 Joplin导出时选 Joplin 原始目录格式链接策略换成ConvertToMarkdown再用原始目录方式导入标签和层级都能对上细节见 doc/migration-to-joplin.md。笔记本多的话配合全部笔记本开关做一次性批量导出睡前跑一轮醒来就齐了。迁移这事从来急不得但最磨人的那一段这个工具已经替你趟平了。剩下的就是打开 Obsidian和那些老笔记好好重逢。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
