企业官网建设流程全解析

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 自带的导出功能，结果是"导出一时爽，整理火葬场"。这篇文章会把它的原理、上手路径、常见坑和进阶配置一次讲透，读完你就能自己跑完一次无损迁移。

先看清单：手工迁移到底输在哪几个环节

把几类常见方案放在一起对比，问题一目了然：

看得出差距集中在三点：层级、链接、附件。这三点恰好也是笔记"骨架"所在。层级丢了，两千篇笔记挤在一个文件夹里；链接失效，笔记之间的引用关系全部归零；附件散落，图片变成一堆乱码文件名。骨架塌了，笔记只是文字，不再是"知识库"。

三个能力点，撑起"导出即所得"的底气

这个工具敢承诺完整保留，靠的是三个设计上的硬功夫。

其一，数据从头到尾不出你的电脑。它通过官方 COM 接口直接驱动本机已安装的 OneNote 和 Word 程序读取原始内容，整个过程不依赖任何云端服务。对存放客户资料、私人日记的用户来说，"数据不上传"本身就是最重要的卖点。

其二，转换走的是"双引擎 + 后处理"流水线。程序先借助 OneNote 的 COM 接口把每一页内容导出为 DocX 文件，再交给内置的 Pandoc 把 DocX 翻译成 Markdown，最后跑一轮基于正则表达式的后处理，修复表格错位、多余换行、多余的引用块等格式毛刺。单步转换容易翻车的复杂表格，在这套流水线里被稳稳兜住。

其三，笔记本的"骨架"被完整映射。分区导出为文件夹，分区组导出为嵌套目录，子页面默认作为父页面的下级文件夹，目录树和你在 OneNote 里看到的结构几乎一一对应。

当然，它也有明确的边界。一张功能清单放在这里，导出前心里有数：

五分钟跑通第一份导出

动手前先核对三件事：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设为ConvertToWikilink，OneNote 内部链接会自动变成[[双链]]格式，双向链接开箱即用；ProcessingOfPageHierarchy保持HierarchyAsFolderTree，层级继续以文件夹呈现；AddFrontMatterHeader设为true，每篇笔记自动带上创建时间和更新时间的 YAML 头，方便后续按日期检索。

给 Joplin 的推荐组合：命令行里选--format 2导出 Joplin 原始目录，链接策略换成ConvertToMarkdown，然后在 Joplin 里通过「文件 → 导入 → RAW - Joplin Export Directory」选择导出文件夹。相比走 ENEX 中转的老办法，这种方式的显著优势是分区层级和页面顺序都能原样保留。

如果编辑器不支持 Markdown 内嵌 HTML，记得把UseHtmlStyling关掉，否则复杂表格和字体颜色会以 HTML 形式暴露在源码里。

收尾：照着这七步，今晚就能搬完

1. 克隆仓库，按上文把pandoc.exe解压就位；
2. 挑一个最常用的小笔记本试跑，全程保持 OneNote 打开并等待同步完成；
3. 对照appSettings.json逐项确认，按目标平台（Obsidian 还是 Joplin）调好链接策略；
4. 导出完成后，随机抽查十几篇带表格、带图片的笔记，确认质量过关；
5. 有报错先看同目录的logs.txt，再针对性地查资料或提问；
6. 分批迁移，先迁常用笔记本，其余留作第二波；
7. 迁移完成前不要删原笔记本，给自己留一条退路。

知识迁移从来不是一夜之间的事，但最痛苦的那一步——让内容完整、结构无损地离开 OneNote——onenote-md-exporter 已经替你走完了。剩下的，就是打开 Obsidian，和那些老笔记好好重逢。😄

【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter