2000 篇 OneNote 笔记一次搬走：OneNote 导出 Markdown 完整实操指南

2000 篇 OneNote 笔记一次搬走OneNote 导出 Markdown 完整实操指南【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter迁移 OneNote 笔记这件事最折磨人的从来不是工作量而是忙活一整晚之后发现表格全散、图片路径全乱、原本的目录层级变成一摊平铺文件。onenote-md-exporter 正是为解决 OneNote 导出 Markdown 的完整性问题而生的本地命令行工具专治导出即残废。很多人在这一步消耗过大量时间手工复制粘贴几百篇笔记复制到手酸用 OneNote 自带的导出功能结果是导出一时爽整理火葬场。这篇文章会把它的原理、上手路径、常见坑和进阶配置一次讲透读完你就能自己跑完一次无损迁移。先看清单手工迁移到底输在哪几个环节把几类常见方案放在一起对比问题一目了然迁移方案成本目录层级内部链接图片与附件数据流向逐篇复制粘贴极高丢失全部失效丢失全程本机OneNote 自带导出中扁平化失效可用全程本机在线转换网站中扁平化失效看运气上传云端onenote-md-exporter低完整保留转为双链完整保留全程本机看得出差距集中在三点层级、链接、附件。这三点恰好也是笔记骨架所在。层级丢了两千篇笔记挤在一个文件夹里链接失效笔记之间的引用关系全部归零附件散落图片变成一堆乱码文件名。骨架塌了笔记只是文字不再是知识库。三个能力点撑起导出即所得的底气这个工具敢承诺完整保留靠的是三个设计上的硬功夫。其一数据从头到尾不出你的电脑。它通过官方 COM 接口直接驱动本机已安装的 OneNote 和 Word 程序读取原始内容整个过程不依赖任何云端服务。对存放客户资料、私人日记的用户来说数据不上传本身就是最重要的卖点。其二转换走的是双引擎 后处理流水线。程序先借助 OneNote 的 COM 接口把每一页内容导出为 DocX 文件再交给内置的 Pandoc 把 DocX 翻译成 Markdown最后跑一轮基于正则表达式的后处理修复表格错位、多余换行、多余的引用块等格式毛刺。单步转换容易翻车的复杂表格在这套流水线里被稳稳兜住。其三笔记本的骨架被完整映射。分区导出为文件夹分区组导出为嵌套目录子页面默认作为父页面的下级文件夹目录树和你在 OneNote 里看到的结构几乎一一对应。当然它也有明确的边界。一张功能清单放在这里导出前心里有数内容类型导出结果图片、文件附件完整保留简单表格转为 Markdown 表格复杂表格保留为 HTMLObsidian、Joplin 均可渲染折叠段落、字体/背景色保留颜色以 HTML 形式任务、星标等标签转为表情符号绘图、墨迹扁平化为图片手写笔迹不支持直接丢失五分钟跑通第一份导出动手前先核对三件事Windows 10 及以上OneNote 2013 及以上微软商店版不支持注意区分Word 2013 及以上。三者缺一转换引擎就转不起来。第一步把仓库拉下来git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter第二步进入src/OneNoteMdExporter/pandoc/目录把里面的pandoc-3.8.3-windows-x86_64.zip解压让pandoc.exe和压缩包待在同一个文件夹。这一步不做程序找不到格式转换器导出会直接失败。第三步启动 OneNote确认要导出的笔记本已经加载并完成同步。这个工具读取的是 OneNote 的实时状态笔记本没打开程序就无从下手。第四步直接双击运行OneNoteMdExporter.exe。它会列出本机所有笔记本你可以勾选要导出的对象、选择格式Markdown 或 Joplin、按需调整高级设置。跑完后会自动弹出导出文件夹第一份 Markdown 就此到手。无人值守一条命令搬空整个笔记本库手动操作适合小规模试跑。笔记本多、又不想盯着界面就用命令行一次搞定OneNoteMdExporter.exe --notebook 我的笔记本 --format 1 --no-input--format 1是 Markdown 文件夹格式--format 2是 Joplin 原始目录格式--no-input表示全自动运行不等待任何交互。想一次性导出全部笔记本加一个参数即可它会自动忽略--notebook指定的名字OneNoteMdExporter.exe --all-notebooks --format 1 --no-input导出完成后你会得到类似这样的结构我的笔记本/ ├─ 工作项目/ │ ├─ 需求文档/ │ │ ├─ 需求评审.md │ │ └─ 技术方案.md │ └─ 周报.md ├─ 生活随笔.md └─ resources/ ├─ 截图1.png └─ 附件.pdf页面是.md文件图片和附件统一收在resources文件夹Markdown 内部用相对路径引用。把这个文件夹整个拖进 Obsidian 仓库就能直接用不需要再改任何路径。正式迁移前过一遍这份自检清单把常见的翻车场景整理成一份自查清单逐项打勾后再开始能省掉大半返工时间。本机 Office 组件异常首次运行报System.Runtime.InteropServices.COMException通常是程序没能和 OneNote 组件握手原因多半是本机 Office 安装有问题。最省事的解法不是重装 Office而是按doc/notebook-onepkg-export.md的说明把笔记本导出成.onepkg包换一台干净的电脑导入后再导出 Markdown效果一样风险更低。导出后图片是坏的多半是 OneNote 本地根本没缓存图片。到「文件 → 选项 → 同步」里勾上下载所有文件和图像强制同步一次再重新导出即可。密码保护的分区变空了锁着的分区内容不会进入结果记得在导出前手动解锁。手写笔迹消失了这是工具明确的边界手写内容不支持转换别把它算进预期里。提示文件路径过长笔记本里有标题超长的页面时把配置里的MdMaxFileLength调小一些从源头规避 Windows 路径长度上限。跑完一遍后检查一下输出目录里的logs.txt有报错先看日志再处理比瞎猜高效得多。进阶配置Obsidian 和 Joplin 各抄一份答案不同平台对 Markdown 的偏好不同好在所有开关都集中在appSettings.json里改一处生效一处。给 Obsidian 的推荐组合把OneNoteLinksHandling设为ConvertToWikilinkOneNote 内部链接会自动变成[[双链]]格式双向链接开箱即用ProcessingOfPageHierarchy保持HierarchyAsFolderTree层级继续以文件夹呈现AddFrontMatterHeader设为true每篇笔记自动带上创建时间和更新时间的 YAML 头方便后续按日期检索。给 Joplin 的推荐组合命令行里选--format 2导出 Joplin 原始目录链接策略换成ConvertToMarkdown然后在 Joplin 里通过「文件 → 导入 → RAW - Joplin Export Directory」选择导出文件夹。相比走 ENEX 中转的老办法这种方式的显著优势是分区层级和页面顺序都能原样保留。如果编辑器不支持 Markdown 内嵌 HTML记得把UseHtmlStyling关掉否则复杂表格和字体颜色会以 HTML 形式暴露在源码里。收尾照着这七步今晚就能搬完克隆仓库按上文把pandoc.exe解压就位挑一个最常用的小笔记本试跑全程保持 OneNote 打开并等待同步完成对照appSettings.json逐项确认按目标平台Obsidian 还是 Joplin调好链接策略导出完成后随机抽查十几篇带表格、带图片的笔记确认质量过关有报错先看同目录的logs.txt再针对性地查资料或提问分批迁移先迁常用笔记本其余留作第二波迁移完成前不要删原笔记本给自己留一条退路。知识迁移从来不是一夜之间的事但最痛苦的那一步——让内容完整、结构无损地离开 OneNote——onenote-md-exporter 已经替你走完了。剩下的就是打开 Obsidian和那些老笔记好好重逢。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考