尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
OneNote 笔记迁移 Obsidian 一次搞定:亲测 onenote-md-exporter 的不踩坑全记录
OneNote 笔记迁移 Obsidian 一次搞定亲测 onenote-md-exporter 的不踩坑全记录【免费下载链接】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 格式适配 Obsidian、Joplin 等主流笔记软件。这篇记录就是他折腾了一周、把笔记成功搬进 Obsidian 的完整迁移手记。第 0 天迁移的念头一起噩梦就开始了去年小宇想把这批笔记迁到 Obsidian第一反应是复制粘贴总行吧。结果贴了三天表格全部散架、图片路径全乱两千多篇笔记变成一摊平铺的文件越整理越绝望。他又试了 OneNote 自带的导出功能层级倒是有了可内部链接全部失效分区一多照样找不到北。中间他还动过用在线转换网站的念头可一想到要把存着客户资料和私人日记的东西上传到别人服务器光想想就脊背发凉。他把几种土办法的体验整理成了一张表越看越觉得这事儿不能这么干迁移方式层级结构内部链接图片附件是否安全手工复制粘贴丢失失效丢失安全OneNote 自带导出扁平化失效可用安全在线转换网站扁平化失效看运气需上传云端onenote-md-exporter完整保留转为双链完整保留全程本地第 1 天它凭什么敢说导出后几乎不用改小宇最初也是半信半疑直到他搞懂了工具的三个关键设计才明白这次为什么不一样。第一数据从头到尾不出你的电脑。它直接调用本机的 OneNote 和 Word 程序官方 COM 接口可以理解成让这两个软件乖乖交出内容的官方钥匙读取原始内容整个过程不依赖任何云端服务。第二笔记本的骨架被完整保留。分区变成文件夹分区组变成嵌套目录子页面默认作为父页面的下级文件夹导出的目录树和你在 OneNote 里看到的结构几乎一一对应。第三它天生就是为 Obsidian、Joplin 这类 Markdown 编辑器设计的。内部链接可以转成[[双链]]格式Obsidian 里点击就能跳转的双向链接每篇笔记能自动加上带创建时间、更新时间的 Front Matter 头文件开头一段 YAML 格式的元信息方便检索还内置了 Pandoc 转换引擎来兜底复杂表格和格式。第 2 天动手之前这份检查清单先过一遍小宇差点在这步翻车因为工具对系统环境有硬性要求。动手前务必先确认Windows 10 及以上系统OneNote 2013 及以上注意微软商店版不支持Word 2013 及以上启动 OneNote确认要导出的笔记本已加载并完成同步密码保护的分区提前手动解锁锁着的分区不会进入导出结果都齐了就开干。第一步拿到工具git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter第二步补上转换引擎。进入src/OneNoteMdExporter/pandoc/目录把里面的pandoc-3.8.3-windows-x86_64.zip解压让pandoc.exe和压缩包待在同一个文件夹。这一步不能省没有它程序就找不到格式转换器后续的 Markdown 翻译全靠它。第 3 天第一次运行就报错差点被劝退小宇满怀期待地双击运行OneNoteMdExporter.exe屏幕上却弹出一长串红字System.Runtime.InteropServices.COMException——程序没能和 OneNote 组件成功握手。他当时差点就把这个工具卸载了后来才知道这个报错十有八九是本机 Office 安装有问题跟工具本身没多大关系。这时候最省事的解法不是重装 Office而是按doc/notebook-onepkg-export.md里的说明把笔记本导出成.onepkg包换一台干净的电脑导入后再导出 Markdown。效果一样风险还更低。如果你也撞上这个报错别慌先试试这条路。第 4 天跑通之后导出的结果长这样换电脑重新跑这次一路绿灯。最简单的方式是直接双击OneNoteMdExporter.exe它会列出本机所有笔记本让你勾选要导出的对象、选择格式还能现场调整高级设置。等它跑完会自动弹出导出文件夹。想要批量或无人值守就用命令行一次指定笔记本和格式OneNoteMdExporter.exe --notebook 我的笔记本 --format 1 --no-input这里的--format 1表示输出为 Markdown 文件夹格式--format 2是 Joplin 原始目录格式--no-input表示全自动、不需要任何交互。导出完成后你会得到类似这样的目录结构我的笔记本/ ├─ 工作项目/ │ ├─ 需求文档/ │ │ ├─ 需求评审.md │ │ └─ 技术方案.md │ └─ 周报.md ├─ 生活随笔.md └─ resources/ ├─ 截图1.png └─ 附件.pdf页面是.md文件图片和附件统一收在resources文件夹里Markdown 内部用相对路径引用——放进 Obsidian 仓库就能直接用不需要再改任何路径。第 5 天图片坏了、分区空了这几个坑我替你踩了小宇抽查时发现几张图片是坏的排查半天多半是 OneNote 本地根本没缓存图片。解决办法很简单到「文件 → 选项 → 同步」里勾上下载所有文件和图像强制同步一次再重新导出基本就能解决。另外还有几个小坑手写笔迹导出后会直接消失这是工具明确的边界文件名太长的页面可能触发 Windows 路径过长的报错这时可以把appSettings.json里的MdMaxFileLength调小一点从源头避开。跑顺之后小宇还总结出两套进阶组合你可以按需取用给 Obsidian 用的推荐组合appSettings.json里的OneNoteLinksHandling设为ConvertToWikilinkOneNote 内部链接变成[[双链]]双向链接直接可用ProcessingOfPageHierarchy保持HierarchyAsFolderTree层级就是文件夹AddFrontMatterHeader设为true每篇笔记自动带上创建/更新时间。一次性导出所有笔记本加个--all-notebooks参数它会忽略--notebook把所有笔记本挨个处理一遍OneNoteMdExporter.exe --all-notebooks --format 1 --no-input第 7 天抽查质量我决定正式搬家小宇随机抽查了十几篇带表格、带图片的笔记质量稳定得让他意外。他后来大致弄明白了原理程序先通过 OneNote COM 接口把每页内容导出成 DocX再用 Pandoc 把 DocX 翻译成 Markdown最后跑一轮正则后处理修复格式毛刺。这种双引擎 后处理的思路确实比他见过的任何单步转换都稳妥。出发前收好这份行动清单如果你也动了迁移的心思不妨按这个顺序来克隆仓库按上文把pandoc.exe解压就位先拿一个最常用的小笔记本试跑全程开着 OneNote 等它同步完成对照appSettings.json里的配置项按你要去的平台Obsidian 还是 Joplin调好链接策略导出完成后随机抽查十几篇带表格、图片的笔记确认质量遇到报错先看同目录下的logs.txt再带着日志去项目里提问或参与改进知识迁移从来不是一夜之间的事但好消息是最痛苦的那一步onenote-md-exporter 已经帮你走完了。剩下的就是打开 Obsidian和那些老笔记好好重逢。想深入了解 Joplin 迁移细节可以翻翻doc/migration-to-joplin.md想参与翻译或贡献代码doc/contribute.md里有完整的指南。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

窗口大小调整神器:Window Resizer 让“拖不动“的窗口也乖乖听话

窗口大小调整神器:Window Resizer 让“拖不动“的窗口也乖乖听话

窗口大小调整神器:Window Resizer 让"拖不动"的窗口也乖乖听话 【免费下载链接】WindowResizer 一个可以强制调整应用程序窗口大小的工具 项目地址: https://gitcode.com/gh_mirrors/wi/WindowResizer 你有没有遇到过这种抓狂时刻:换了…

📅 2026/8/25 10:40:27
KMS激活工具终极指南:一个cmd文件让Windows和Office自动续期180天

KMS激活工具终极指南:一个cmd文件让Windows和Office自动续期180天

KMS激活工具终极指南:一个cmd文件让Windows和Office自动续期180天 【免费下载链接】KMS_VL_ALL_AIO Smart Activation Script 项目地址: https://gitcode.com/gh_mirrors/km/KMS_VL_ALL_AIO 如果屏幕右下角突然跳出"你的Windows许可证即将过期"&am…

📅 2026/8/25 14:19:47
跨境工具是什么?跨境电商卖家必备的数据分析工具全解析

跨境工具是什么?跨境电商卖家必备的数据分析工具全解析

刚入行那段时间,一听到"分析"这个词,脑子里想的都是:是不是那种能自动选品、自动定价、一键爆单的神器? 说实话,我刚开始接触这行也这么想过。后来才明白,真正能帮上忙的,做的不是什…

📅 2026/8/25 17:40:11
MORE NEWS

更多资讯

📰

Unity 2D黄金矿工开发实战:物理参数、DistanceJoint2D关节与碰撞检测全解析

简介:这份Unity黄金矿工游戏项目为2D游戏学习者提供了完整的工程源码与导出文件,适合想通过实际案例掌握Unity工作流、C#脚本编写、物理交互与UI搭建的开发者,无论是高校学生、独立开发者还是培训机构,都可将其作为教学或自学素材…

📰

Nginx Proxy Manager实战:告别IP加端口,统一内网服务域名

1. 先别急,聊聊这段痛苦的"IP加端口"日子我猜你和我一样,电脑上存着一大堆书签,全是类似192.168.1.5:3000、192.168.1.5:8080、192.168.1.8:5601这样的地址。每次想打开个服务,都得先回忆那串数字,要不就在路…

📰

车辆调度思维链:把老师傅经验变成可解释的决策流程

做运力调度这一行的人,应该都有过这种体验:早上八点,调度室屏幕一开,几十个新订单涌进来,仓库那边催着装货,司机蹲在车边抽烟等你分活,紧接着又来一个“急单必须十点前送到”的电话。新手调度员…

📰

2026 AI编程工具全景解析:从IDE插件到Agent的选型指南

这两年AI编程圈子的变化速度,说实话比我过去十年经历过的任何一次技术浪潮都要猛。2023年大家还在讨论AI能不能写代码,2024年在比谁家的补全更聪明,到了2025年下半年再到2026年,局面已经完全变了——AI不再只是“帮你补全下一行”…

📰

CSGO盲盒开箱源码解析:概率算法、对战结算与防刷设计

简介:面向CSGO游戏开发者与服务器运营者的一套盲盒开箱源码,将盲盒对战、幸运开箱、积分商城和Fl盲盒机制整合为可部署系统,解决从零开发成本高、玩法集成难的问题,提升玩家互动与留存。压缩包共2000个文件,以md笔记、…

📰

Python+uniapp预约小程序实战:从疫苗预约到通用预约系统

2023年之后再看这个项目名字,多少带点时间印记。但把“Python_uniapp-新冠疫苗预约小程序”拆开看,它本质上是一个特别典型的预约业务系统:Python 提供接口,uniapp 搭小程序前端,用户登录、选择时间场次、锁定名额、生…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬