OneNote 迁移实战终极指南onenote-md-exporter 5 步完成笔记无损转换【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter深夜十一点前端工程师阿哲盯着屏幕发愁他在 OneNote 里攒了六年的八百多篇技术笔记眼看就要随着公司回收 Office 账号一起消失。他试过复制粘贴格式碎成一地也试过在线转换工具结果第一步就要求把整个笔记本上传云端他犹豫了。直到有人向他推荐了 onenote-md-exporter——一款能在本地把 OneNote 笔记本完整导出为 Markdown 的命令行工具这段迁移故事才终于迎来转机。如果你也囤着几年的笔记不敢动或者正打算从 OneNote 搬到 Obsidian、Joplin 这类现代笔记软件这篇实战指南就是为你准备的。我们不谈虚的从为什么会踩坑讲到五步完成首次导出再到不同身份的人怎么把工具用到极致一次讲透。迁移前 vs 迁移后差的不只是文件格式先别急着操作。动工之前我们先回答一个关键问题为什么不能直接在 OneNote 里导出、再手动搬过去答案藏在下面这张对照表里。同样是搬笔记用对工具和用手工搬运体验完全是两回事。对比维度迁移前困在 OneNote 里迁移后落入 Markdown 生态排版与格式表格、字体颜色、嵌入文件换个软件就乱简单表格转成 Markdown复杂表格保留为 HTML图片附件原位存放层级结构笔记本→分区→页面搬出去就塌方成一层分区与子分区变成文件夹父页面变成子页面的文件夹内部链接OneNote 专属链接在别处全是死链自动改写为 Wiki 链接或标准 Markdown 链接数据隐私在线工具必须上传全部笔记全程本地处理笔记不离开你的电脑长期价值私有格式随时可能被生态绑架开放的 .md 文本任何编辑器都能打开天然适合备份检索能力只能在 OneNote 里搜可以被 Obsidian、Joplin 全文索引本地搜索又快又准一句话总结手工搬运是在搬家而这款工具是在整栋楼平移——楼层关系、房间里的家具摆设尽量原样保留。当然尽量两个字背后藏着不少细节。听起来很美好先别急着下结论我们直接从零开始走一遍完整流程你自己感受一下。五步完成首次导出从环境准备到看见成果记住一个原则先跑通再优化。第一次别追求完美配置用默认参数导出成功就算迈过了最大的一道坎。第 1 步确认环境达标onenote-md-exporter 是个 Windows 下的控制台程序对你的电脑有三个基本要求操作系统Windows 10 及以上OneNote2013 或更高版本注意Windows 商店版不支持请用桌面版Word2013 或更高版本前两项好理解为什么还要 Word后面讲原理时会解释——它和 Pandoc 一起是转换链路里的关键角色。先记住这三样缺一不可。 小贴士发布版本是 .NET 10 的自包含程序解压即用通常不需要额外安装运行时。只有从源码自己编译时才需要准备开发环境。第 2 步拿到工具两种方式任选其一懒人路线直接下载最新发布的压缩包解压到任意目录折腾路线动手克隆源码自己构建# 克隆项目源码适合想二次开发或自行编译的读者 git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter无论哪条路解压后请留意src/OneNoteMdExporter/pandoc/目录——里面有一个pandoc-3.8.3-windows-x86_64.zip压缩包。把它解开让pandoc.exe与程序在同一目录下否则后面的格式转换会罢工。第 3 步让 OneNote 做好准备启动 OneNote确认你要导出的笔记本已经加载、并且同步完成。这一步看起来无关紧要其实是最常见的翻车点OneNote 的云端同步策略比较佛系有些图片和附件只存了缩略图。如果本机没有完整内容导出结果就会缺图少件。后面避坑部分还会专门讲它。第 4 步跑起来选笔记本、选格式直接双击运行OneNoteMdExporter.exe它会列出检测到的所有笔记本你输入编号即可选择。接着它会问你导出格式输入 1Markdown 文件夹格式——适合 Obsidian、Logseq 这类通用 Markdown 编辑器输入 2Joplin 原始目录格式——专门给 Joplin 用的导入后连笔记层级都给你建好。选完格式程序会问你要不要现在改设置。第一次建议直接回车跳过用默认值就好。**然后呢去冲杯咖啡。**☕ 导出期间程序会逐页处理结束后会自动用资源管理器打开导出文件夹让你第一时间看到成果。第 5 步认识你的导出结果打开导出文件夹你会看到这样的结构我的笔记本/ ├── 分区A/ │ ├── 父页面/ │ │ ├── 子页面.md │ ├── 普通页面.md │ └── resources/ # 图片与附件集中存放处 ├── 分区B/ │ └── ...分区变成文件夹页面变成.md文件图片和附件集中放在resources目录Markdown 里用相对路径引用它们。整个目录拿到任何 Markdown 编辑器里都能直接打开。⚠️ 注意默认配置下页面在分区内的排序依赖文件名。如果顺序对你不重要可以忽略如果很在意建议改用 Joplin 格式它保留原始顺序。按需分层定制基础、进阶、极致三种玩法跑通只是第一步。想让导出结果长得像你原来的笔记你得学会调参。所有配置都写在程序目录下的appSettings.json文件里点击查看默认配置分三个层次理解就够。基础需求三个参数解决 80% 的问题绝大多数个人用户改这三个就够了{ AddFrontMatterHeader: true, // 每页开头加 YAML 元数据标题、创建/修改时间 ProcessingOfPageHierarchy: HierarchyAsFolderTree, // 父页面作为子页面的文件夹 OneNoteLinksHandling: ConvertToWikilink // 内部链接转成 [[Wiki链接]]Obsidian 双链友好 }想去 Obsidian 玩双向链接把OneNoteLinksHandling设为ConvertToWikilink想去 Joplin改成ConvertToMarkdown更合适什么都不想要就想把链接删干净设为Remove。进阶需求按场景挑着改{ ResourceFolderLocation: RootFolder, // 所有图片附件集中放在根目录 resources 文件夹 PanDocMarkdownFormat: gfm, // 用 GitHub 风格 Markdown 语法 UseHtmlStyling: true, // 允许用 HTML 保留字体颜色、背景色等样式 IndentingStyle: ConvertToBullets // OneNote 缩进转成列表观感最接近原笔记 }ResourceFolderLocation有两个值RootFolder集中存放和PageParentFolder每个页面旁边各放一份资源。图片多的笔记本用前者省心想每个页面自成一体、方便单独分享时用后者。UseHtmlStyling尤其值得注意如果你用的编辑器支持 HTMLObsidian、Joplin 都支持务必开着它能帮你保住字体颜色、背景色这些 Markdown 表达不了的东西。极致需求为大型笔记本兜底{ PageTitleMaxLength: 50, // 页面标题超长时自动截断避免文件名过长 MdMaxFileLength: 50, // 限制文件与文件夹名长度防止路径超长报错 PostProcessingRemoveQuotationBlocks: true, // 去掉 Pandoc 偶发产生的多余引用块 MaxTwoLineBreaksInARow: true // 最多允许连续两个换行版面更干净 }这四个是保险丝级别的参数平时不用动等你遇到路径过长、空行过多这类问题再回来翻它们。参数再好最终还是要落到具体的人身上。下面这三个真实场景或许你能在某个故事里看到自己的影子。三个人的迁移故事他们是这样用的故事一知识管理爱好者小鹿把 1200 篇笔记搬进 Obsidian小鹿是位产品经理Obsidian 用了两年却始终有一块心病主力笔记还在 OneNote 里两边割裂检索全靠回忆。她给自己定了个三步走计划。第一步先用一个测试笔记本跑通流程确认ProcessingOfPageHierarchy HierarchyAsFolderTree下层级没塌第二步把OneNoteLinksHandling调成ConvertToWikilink让旧笔记里的互链变成 Obsidian 的双链第三步开着AddFrontMatterHeader让每篇笔记自带时间戳。第一次导出完我打开 Obsidian 的图谱视图看到几千个节点连成一片当时就愣住了。小鹿说那一刻才真正感觉我的知识资产是自己的了。故事二咨询公司 IT 负责人老周三天搞定团队文档迁移老周所在的团队有二十多人笔记散落在项目文档会议记录客户资料等好几个笔记本里要统一迁到团队知识库。他的思路是先集中、再分发把ResourceFolderLocation设为RootFolder所有图片集中管理然后用一个批处理脚本逐个笔记本导出全程无人值守REM 批量导出多个笔记本配合 --no-input 跳过交互--ignore-errors 让单个失败不中断 for %%i in (项目文档 会议记录 客户资料) do ( OneNoteMdExporter.exe --notebook %%i --format 1 --no-input --ignore-errors )脚本跑完那晚我基本没管它第二天早上来三个笔记本整整齐齐躺在共享盘里。老周的经验是迁移团队知识库最怕的不是慢而是中断后没人盯着。故事三自动化爱好者大刘把导出变成下班自动执行大刘是运维出身他不想每次手动点。他研究了命令行参数后发现工具支持--notebook、--format、--section、--page等参数甚至能精确到只导出某个分区的某一页。他把自己的学习笔记笔记本做成一个计划任务每周五 18:00 自动执行一次全量导出作为备份# 全自动备份导出全部笔记本无需任何交互输入 OneNoteMdExporter.exe --all-notebooks --format 1 --no-input数据安全这事儿靠自觉靠不住靠定时任务才靠得住。大刘的这句话值得每个笔记重度用户记下来。三个故事都很顺利别高兴太早。真实世界里总有几个坑在前面等着你。高频问题自查清单遇到报错先看这里Q1一启动就报System.Runtime.InteropServices.COMException这是最常见的报错多半不是你操作的问题而是本机 Office/OneNote 组件状态异常。按顺序排查重启 OneNote 和 Word再运行一次程序确认你用的是 OneNote 桌面版而不是 Windows 商店版如果还不行按这篇文档把笔记本导出成.onepkg包换一台干净的机器导入后再导出。Q2导出后图片显示不出来 / 变成空白十有八九是 OneNote 本地没有完整的图片文件。解决办法打开 OneNote文件 → 选项 → 同步勾选下载所有文件和图像强制同步一次笔记本重新导出。这条建议来自官方 FAQ属于命中率最高的修复方案。Q3大型笔记本导出又慢又卡大库的处理时间主要花在逐页转格式上。可以这样拆解先只导一个分区试试水用--section参数控制范围确认流程无误再全量导出给程序留足磁盘空间和内存导出目录别放在快满的盘上导出期间别在 OneNote 里继续编辑笔记避免文件占用冲突。Q4有些内容消失了先对照这张能力边界表看消失的是不是本就支持的内容内容类型导出结果文本、简单表格✅ 完整保留复杂表格、字体/背景色✅ 以 HTML 形式保留图片、附件✅ 原样保存文本标签待办、星标等✅ 转为表情符号绘图内容 拍平成图片密码保护的分区 需先在 OneNote 里解锁手写笔迹 无法转换迁移前记得先解锁所有受密码保护的分区——这是最容易被忽略的一条。搞清楚了边界我们再往深挖一层这套无损转换到底是怎么实现的背后的原理一位翻译官和一位校对编辑把 onenote-md-exporter 想象成一个三人翻译团队你就能理解它的工作方式读原文它通过 OneNote 的 COM 接口把每个页面的内容本质是 XML 结构读取出来做一轮预处理——把折叠段落展开、记录字体颜色等细节打草稿把页面内容先转成临时的 DocX 文档——这就是为什么需要安装 Word正式翻译调用 Pandoc——那位通用格式翻译官把 DocX 转成 Markdown校对编辑用一系列正则规则做后处理修复格式转换产生的错别字比如去掉多余的引用块、合并连续空行。OneNote 页面 XML → 临时 DocX → Pandoc 转 Markdown → 正则后处理 → 最终 .md 资源文件夹整个过程完全在本地进行不依赖微软云这也是它敢承诺数据安全的底气所在。 顺带一提整套翻译流程是读原文再转述所以 OneNote 里的层级结构、页面顺序这类骨架信息理论上可以做到近乎无损地搬进 Markdown 生态。核心转换逻辑在 src/OneNoteMdExporter/Services/Export/ 目录下感兴趣的读者可以去翻翻源码。理解了原理接下来就是把工具用到极致的时候了。效率进阶从能用到好用的四个技巧技巧一按需导出别每次都全量跑只想找一篇旧笔记用--section限定分区用--page精确到页面几秒钟就出结果不必为整本笔记本付等待时间。技巧二给 Joplin 用户一条捷径如果你最终要去的是 Joplin直接选格式 2Joplin 原始目录然后打开 Joplin文件 → 导入 → RAW - Joplin Export Directory选中导出文件夹即可。相比先导 ENEX 再导 Joplin 的绕路方案这个流程能保住分区层级和页面顺序细节对比见官方迁移文档。技巧三用测试笔记本降低试错成本仓库里附带了一个样例笔记本 sample/TestNotebook.onepkg。正式迁移前先用它或自己建的小笔记本跑一遍各种配置组合确认效果再上真库风险最小。技巧四导出后的质量检查清单每次导出完成花五分钟抽查三件事结构对不对文件夹层级和原笔记本的分区、子分区是否一一对应内容全不全随机抽 10% 的页面重点看表格、图片、代码块链接灵不灵点开几处内部链接确认 Wiki 链接能跳转到目标页面。顺便说一句如果你用下来觉得不错这个项目欢迎任何形式的参与——界面支持多语言翻译文件放在 src/OneNoteMdExporter/Resources/ 目录想提交新功能或导出格式可以参照 doc/contribute.md 里的约定把测试样例一起附上即可。现在轮到你了回顾整篇文章其实就一句话onenote-md-exporter 帮你把 OneNote 迁移这件事从高风险、高成本的手工活变成了可重复、可验证的脚本活。你的笔记不会再被单一生态锁死你的知识资产从此有了开放的格式作为退路。别等有空再说了。按下面这份行动清单现在就动手检查电脑上的 OneNote 和 Word 版本确认是桌面版且不低于 2013下载或克隆工具解压 pandoc 压缩包到程序目录用一个小型测试笔记本跑通首次导出验证 Markdown 文件夹结构按你的目标平台Obsidian 选 Wiki 链接、Joplin 选 Markdown 链接调整appSettings.json全量导出前记得先解锁所有密码保护的分区、确保图片已完整下载导出完成后抽查质量然后——把备份脚本加入你的定期任务清单。知识迁移是场马拉松但最艰难的一步永远是开始。工具已经就位剩下的交给你了。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OneNote 迁移实战终极指南：onenote-md-exporter 5 步完成笔记无损转换
OneNote 迁移实战终极指南onenote-md-exporter 5 步完成笔记无损转换【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter深夜十一点前端工程师阿哲盯着屏幕发愁他在 OneNote 里攒了六年的八百多篇技术笔记眼看就要随着公司回收 Office 账号一起消失。他试过复制粘贴格式碎成一地也试过在线转换工具结果第一步就要求把整个笔记本上传云端他犹豫了。直到有人向他推荐了 onenote-md-exporter——一款能在本地把 OneNote 笔记本完整导出为 Markdown 的命令行工具这段迁移故事才终于迎来转机。如果你也囤着几年的笔记不敢动或者正打算从 OneNote 搬到 Obsidian、Joplin 这类现代笔记软件这篇实战指南就是为你准备的。我们不谈虚的从为什么会踩坑讲到五步完成首次导出再到不同身份的人怎么把工具用到极致一次讲透。迁移前 vs 迁移后差的不只是文件格式先别急着操作。动工之前我们先回答一个关键问题为什么不能直接在 OneNote 里导出、再手动搬过去答案藏在下面这张对照表里。同样是搬笔记用对工具和用手工搬运体验完全是两回事。对比维度迁移前困在 OneNote 里迁移后落入 Markdown 生态排版与格式表格、字体颜色、嵌入文件换个软件就乱简单表格转成 Markdown复杂表格保留为 HTML图片附件原位存放层级结构笔记本→分区→页面搬出去就塌方成一层分区与子分区变成文件夹父页面变成子页面的文件夹内部链接OneNote 专属链接在别处全是死链自动改写为 Wiki 链接或标准 Markdown 链接数据隐私在线工具必须上传全部笔记全程本地处理笔记不离开你的电脑长期价值私有格式随时可能被生态绑架开放的 .md 文本任何编辑器都能打开天然适合备份检索能力只能在 OneNote 里搜可以被 Obsidian、Joplin 全文索引本地搜索又快又准一句话总结手工搬运是在搬家而这款工具是在整栋楼平移——楼层关系、房间里的家具摆设尽量原样保留。当然尽量两个字背后藏着不少细节。听起来很美好先别急着下结论我们直接从零开始走一遍完整流程你自己感受一下。五步完成首次导出从环境准备到看见成果记住一个原则先跑通再优化。第一次别追求完美配置用默认参数导出成功就算迈过了最大的一道坎。第 1 步确认环境达标onenote-md-exporter 是个 Windows 下的控制台程序对你的电脑有三个基本要求操作系统Windows 10 及以上OneNote2013 或更高版本注意Windows 商店版不支持请用桌面版Word2013 或更高版本前两项好理解为什么还要 Word后面讲原理时会解释——它和 Pandoc 一起是转换链路里的关键角色。先记住这三样缺一不可。 小贴士发布版本是 .NET 10 的自包含程序解压即用通常不需要额外安装运行时。只有从源码自己编译时才需要准备开发环境。第 2 步拿到工具两种方式任选其一懒人路线直接下载最新发布的压缩包解压到任意目录折腾路线动手克隆源码自己构建# 克隆项目源码适合想二次开发或自行编译的读者 git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter无论哪条路解压后请留意src/OneNoteMdExporter/pandoc/目录——里面有一个pandoc-3.8.3-windows-x86_64.zip压缩包。把它解开让pandoc.exe与程序在同一目录下否则后面的格式转换会罢工。第 3 步让 OneNote 做好准备启动 OneNote确认你要导出的笔记本已经加载、并且同步完成。这一步看起来无关紧要其实是最常见的翻车点OneNote 的云端同步策略比较佛系有些图片和附件只存了缩略图。如果本机没有完整内容导出结果就会缺图少件。后面避坑部分还会专门讲它。第 4 步跑起来选笔记本、选格式直接双击运行OneNoteMdExporter.exe它会列出检测到的所有笔记本你输入编号即可选择。接着它会问你导出格式输入 1Markdown 文件夹格式——适合 Obsidian、Logseq 这类通用 Markdown 编辑器输入 2Joplin 原始目录格式——专门给 Joplin 用的导入后连笔记层级都给你建好。选完格式程序会问你要不要现在改设置。第一次建议直接回车跳过用默认值就好。**然后呢去冲杯咖啡。**☕ 导出期间程序会逐页处理结束后会自动用资源管理器打开导出文件夹让你第一时间看到成果。第 5 步认识你的导出结果打开导出文件夹你会看到这样的结构我的笔记本/ ├── 分区A/ │ ├── 父页面/ │ │ ├── 子页面.md │ ├── 普通页面.md │ └── resources/ # 图片与附件集中存放处 ├── 分区B/ │ └── ...分区变成文件夹页面变成.md文件图片和附件集中放在resources目录Markdown 里用相对路径引用它们。整个目录拿到任何 Markdown 编辑器里都能直接打开。⚠️ 注意默认配置下页面在分区内的排序依赖文件名。如果顺序对你不重要可以忽略如果很在意建议改用 Joplin 格式它保留原始顺序。按需分层定制基础、进阶、极致三种玩法跑通只是第一步。想让导出结果长得像你原来的笔记你得学会调参。所有配置都写在程序目录下的appSettings.json文件里点击查看默认配置分三个层次理解就够。基础需求三个参数解决 80% 的问题绝大多数个人用户改这三个就够了{ AddFrontMatterHeader: true, // 每页开头加 YAML 元数据标题、创建/修改时间 ProcessingOfPageHierarchy: HierarchyAsFolderTree, // 父页面作为子页面的文件夹 OneNoteLinksHandling: ConvertToWikilink // 内部链接转成 [[Wiki链接]]Obsidian 双链友好 }想去 Obsidian 玩双向链接把OneNoteLinksHandling设为ConvertToWikilink想去 Joplin改成ConvertToMarkdown更合适什么都不想要就想把链接删干净设为Remove。进阶需求按场景挑着改{ ResourceFolderLocation: RootFolder, // 所有图片附件集中放在根目录 resources 文件夹 PanDocMarkdownFormat: gfm, // 用 GitHub 风格 Markdown 语法 UseHtmlStyling: true, // 允许用 HTML 保留字体颜色、背景色等样式 IndentingStyle: ConvertToBullets // OneNote 缩进转成列表观感最接近原笔记 }ResourceFolderLocation有两个值RootFolder集中存放和PageParentFolder每个页面旁边各放一份资源。图片多的笔记本用前者省心想每个页面自成一体、方便单独分享时用后者。UseHtmlStyling尤其值得注意如果你用的编辑器支持 HTMLObsidian、Joplin 都支持务必开着它能帮你保住字体颜色、背景色这些 Markdown 表达不了的东西。极致需求为大型笔记本兜底{ PageTitleMaxLength: 50, // 页面标题超长时自动截断避免文件名过长 MdMaxFileLength: 50, // 限制文件与文件夹名长度防止路径超长报错 PostProcessingRemoveQuotationBlocks: true, // 去掉 Pandoc 偶发产生的多余引用块 MaxTwoLineBreaksInARow: true // 最多允许连续两个换行版面更干净 }这四个是保险丝级别的参数平时不用动等你遇到路径过长、空行过多这类问题再回来翻它们。参数再好最终还是要落到具体的人身上。下面这三个真实场景或许你能在某个故事里看到自己的影子。三个人的迁移故事他们是这样用的故事一知识管理爱好者小鹿把 1200 篇笔记搬进 Obsidian小鹿是位产品经理Obsidian 用了两年却始终有一块心病主力笔记还在 OneNote 里两边割裂检索全靠回忆。她给自己定了个三步走计划。第一步先用一个测试笔记本跑通流程确认ProcessingOfPageHierarchy HierarchyAsFolderTree下层级没塌第二步把OneNoteLinksHandling调成ConvertToWikilink让旧笔记里的互链变成 Obsidian 的双链第三步开着AddFrontMatterHeader让每篇笔记自带时间戳。第一次导出完我打开 Obsidian 的图谱视图看到几千个节点连成一片当时就愣住了。小鹿说那一刻才真正感觉我的知识资产是自己的了。故事二咨询公司 IT 负责人老周三天搞定团队文档迁移老周所在的团队有二十多人笔记散落在项目文档会议记录客户资料等好几个笔记本里要统一迁到团队知识库。他的思路是先集中、再分发把ResourceFolderLocation设为RootFolder所有图片集中管理然后用一个批处理脚本逐个笔记本导出全程无人值守REM 批量导出多个笔记本配合 --no-input 跳过交互--ignore-errors 让单个失败不中断 for %%i in (项目文档 会议记录 客户资料) do ( OneNoteMdExporter.exe --notebook %%i --format 1 --no-input --ignore-errors )脚本跑完那晚我基本没管它第二天早上来三个笔记本整整齐齐躺在共享盘里。老周的经验是迁移团队知识库最怕的不是慢而是中断后没人盯着。故事三自动化爱好者大刘把导出变成下班自动执行大刘是运维出身他不想每次手动点。他研究了命令行参数后发现工具支持--notebook、--format、--section、--page等参数甚至能精确到只导出某个分区的某一页。他把自己的学习笔记笔记本做成一个计划任务每周五 18:00 自动执行一次全量导出作为备份# 全自动备份导出全部笔记本无需任何交互输入 OneNoteMdExporter.exe --all-notebooks --format 1 --no-input数据安全这事儿靠自觉靠不住靠定时任务才靠得住。大刘的这句话值得每个笔记重度用户记下来。三个故事都很顺利别高兴太早。真实世界里总有几个坑在前面等着你。高频问题自查清单遇到报错先看这里Q1一启动就报System.Runtime.InteropServices.COMException这是最常见的报错多半不是你操作的问题而是本机 Office/OneNote 组件状态异常。按顺序排查重启 OneNote 和 Word再运行一次程序确认你用的是 OneNote 桌面版而不是 Windows 商店版如果还不行按这篇文档把笔记本导出成.onepkg包换一台干净的机器导入后再导出。Q2导出后图片显示不出来 / 变成空白十有八九是 OneNote 本地没有完整的图片文件。解决办法打开 OneNote文件 → 选项 → 同步勾选下载所有文件和图像强制同步一次笔记本重新导出。这条建议来自官方 FAQ属于命中率最高的修复方案。Q3大型笔记本导出又慢又卡大库的处理时间主要花在逐页转格式上。可以这样拆解先只导一个分区试试水用--section参数控制范围确认流程无误再全量导出给程序留足磁盘空间和内存导出目录别放在快满的盘上导出期间别在 OneNote 里继续编辑笔记避免文件占用冲突。Q4有些内容消失了先对照这张能力边界表看消失的是不是本就支持的内容内容类型导出结果文本、简单表格✅ 完整保留复杂表格、字体/背景色✅ 以 HTML 形式保留图片、附件✅ 原样保存文本标签待办、星标等✅ 转为表情符号绘图内容 拍平成图片密码保护的分区 需先在 OneNote 里解锁手写笔迹 无法转换迁移前记得先解锁所有受密码保护的分区——这是最容易被忽略的一条。搞清楚了边界我们再往深挖一层这套无损转换到底是怎么实现的背后的原理一位翻译官和一位校对编辑把 onenote-md-exporter 想象成一个三人翻译团队你就能理解它的工作方式读原文它通过 OneNote 的 COM 接口把每个页面的内容本质是 XML 结构读取出来做一轮预处理——把折叠段落展开、记录字体颜色等细节打草稿把页面内容先转成临时的 DocX 文档——这就是为什么需要安装 Word正式翻译调用 Pandoc——那位通用格式翻译官把 DocX 转成 Markdown校对编辑用一系列正则规则做后处理修复格式转换产生的错别字比如去掉多余的引用块、合并连续空行。OneNote 页面 XML → 临时 DocX → Pandoc 转 Markdown → 正则后处理 → 最终 .md 资源文件夹整个过程完全在本地进行不依赖微软云这也是它敢承诺数据安全的底气所在。 顺带一提整套翻译流程是读原文再转述所以 OneNote 里的层级结构、页面顺序这类骨架信息理论上可以做到近乎无损地搬进 Markdown 生态。核心转换逻辑在 src/OneNoteMdExporter/Services/Export/ 目录下感兴趣的读者可以去翻翻源码。理解了原理接下来就是把工具用到极致的时候了。效率进阶从能用到好用的四个技巧技巧一按需导出别每次都全量跑只想找一篇旧笔记用--section限定分区用--page精确到页面几秒钟就出结果不必为整本笔记本付等待时间。技巧二给 Joplin 用户一条捷径如果你最终要去的是 Joplin直接选格式 2Joplin 原始目录然后打开 Joplin文件 → 导入 → RAW - Joplin Export Directory选中导出文件夹即可。相比先导 ENEX 再导 Joplin 的绕路方案这个流程能保住分区层级和页面顺序细节对比见官方迁移文档。技巧三用测试笔记本降低试错成本仓库里附带了一个样例笔记本 sample/TestNotebook.onepkg。正式迁移前先用它或自己建的小笔记本跑一遍各种配置组合确认效果再上真库风险最小。技巧四导出后的质量检查清单每次导出完成花五分钟抽查三件事结构对不对文件夹层级和原笔记本的分区、子分区是否一一对应内容全不全随机抽 10% 的页面重点看表格、图片、代码块链接灵不灵点开几处内部链接确认 Wiki 链接能跳转到目标页面。顺便说一句如果你用下来觉得不错这个项目欢迎任何形式的参与——界面支持多语言翻译文件放在 src/OneNoteMdExporter/Resources/ 目录想提交新功能或导出格式可以参照 doc/contribute.md 里的约定把测试样例一起附上即可。现在轮到你了回顾整篇文章其实就一句话onenote-md-exporter 帮你把 OneNote 迁移这件事从高风险、高成本的手工活变成了可重复、可验证的脚本活。你的笔记不会再被单一生态锁死你的知识资产从此有了开放的格式作为退路。别等有空再说了。按下面这份行动清单现在就动手检查电脑上的 OneNote 和 Word 版本确认是桌面版且不低于 2013下载或克隆工具解压 pandoc 压缩包到程序目录用一个小型测试笔记本跑通首次导出验证 Markdown 文件夹结构按你的目标平台Obsidian 选 Wiki 链接、Joplin 选 Markdown 链接调整appSettings.json全量导出前记得先解锁所有密码保护的分区、确保图片已完整下载导出完成后抽查质量然后——把备份脚本加入你的定期任务清单。知识迁移是场马拉松但最艰难的一步永远是开始。工具已经就位剩下的交给你了。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考