拓冰网站定制 
一条命令把 OneNote 笔记完整导出成 Markdownonenote-md-exporter 迁移 Obsidian 完整避坑指南【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter把攒了多年的 OneNote 笔记搬进 Obsidian最怕的不是内容多而是结构散、图片乱、链接失效。onenote-md-exporter 是一个在本地运行的命令行工具能把 OneNote 笔记本完整导出为 Markdown 格式适配 Obsidian、Joplin 等主流笔记软件。这篇指南从环境准备讲到进阶配置照着做你也能一次迁移成功。先别急着复制粘贴说说大多数人卡在哪试过的人都有体会OneNote 里的目录整整齐齐一导出就变成一摊平铺的文件正文里的图片路径全乱表格散架页面之间的互相引用也全部失效。手工复制粘贴要花好几个周末OneNote 自带的导出又几乎不可用在线转换工具还得把私人笔记传到别人服务器上——光是想想就劝退。如果你也卡在这个死胡同里下面这个本地工具值得花十分钟试一次。它凭什么能导出后几乎不用改三个关键设计第一数据从头到尾不出你的电脑。工具直接调用本机安装的 OneNote 和 Word官方 COM 接口读取原始内容全程离线不依赖任何云端服务。对存着客户资料、私人日记的笔记本来说这是最让人安心的部分。第二笔记本的骨架被完整保留。分区变成文件夹分区组变成嵌套目录子页面默认作为父页面的下级文件夹。导出的目录树和你在 OneNote 里看到的结构几乎一一对应而不是把所有页面哗啦一下倒进同一个文件夹。第三它天生就是为 Obsidian、Joplin 这类 Markdown 编辑器设计的。内部链接可以转成[[双链]]格式每篇笔记自动带上带创建时间、更新时间的 Front Matter 头还内置 Pandoc 转换引擎兜底复杂表格和格式。它的转换管线也很扎实先通过 OneNote COM 接口把每页内容导出成 DocX再用 Pandoc 把 DocX 翻译成 Markdown最后跑一轮正则后处理修复格式毛刺。这种双引擎 后处理的思路比任何单步转换都稳妥。一张表看清四种迁移方式迁移方式层级结构内部链接图片附件是否安全手工复制粘贴丢失失效丢失安全OneNote 自带导出扁平化失效可用安全在线转换网站扁平化失效看运气需上传云端onenote-md-exporter完整保留转为双链完整保留全程本地从下载到导出照着做就行动手之前先确认三件事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它会列出本机所有笔记本让你勾选要导出的对象、选择格式1 是 Markdown2 是 Joplin 原始目录格式还能现场调整高级设置。等它跑完会自动弹出导出文件夹。想要批量或无人值守用命令行一次指定笔记本和格式OneNoteMdExporter.exe --notebook 我的笔记本 --format 1 --no-input导出完成后你会得到类似这样的目录结构我的笔记本/ ├─ 工作项目/ │ ├─ 需求文档/ │ │ ├─ 需求评审.md │ │ └─ 技术方案.md │ └─ 周报.md ├─ 生活随笔.md └─ resources/ ├─ 截图1.png └─ 附件.pdf页面是.md文件图片和附件统一收在resources文件夹里Markdown 内部用相对路径引用。放进 Obsidian 仓库就能直接用不需要再改任何路径。第一次运行必踩的坑现象、原因、解法启动就报System.Runtime.InteropServices.COMException这通常是程序没能和 OneNote 组件握手常见原因是本机 Office 安装有问题。最省事的解法不是重装 Office而是按doc/notebook-onepkg-export.md里的说明把笔记本导出成.onepkg包换一台干净的电脑导入后再导出 Markdown——效果一样风险更低。导出后图片是坏的多半是 OneNote 本地根本没缓存图片。到「文件 → 选项 → 同步」里勾上下载所有文件和图像强制同步一次再重新导出基本就能解决。密码保护的分区变空了记得在导出前手动解锁锁着的分区内容不会进入结果。手写笔迹直接消失这是工具明确的边界手写内容不支持转换导出前心里要有数。文件名太长导致路径超限笔记本里有标题超长的页面时可以在配置里把MdMaxFileLength调小一点从源头避免 Windows 路径过长的报错。如果还是找不到原因导出目录下会生成一份logs.txt日志带着它去项目里提问能省下大量来回沟通的时间。进阶三组配置组合按你的目标平台直接抄工具的高级设置都集中在appSettings.json里用记事本打开就能改。下面是三组经过验证的组合给 Obsidian 用默认组合基本不用动。把OneNoteLinksHandling设为ConvertToWikilinkOneNote 内部链接变成[[双链]]双向链接直接可用ProcessingOfPageHierarchy保持HierarchyAsFolderTree层级就是文件夹AddFrontMatterHeader设为true每篇笔记自动带上创建/更新时间方便检索。导出的每篇笔记都会带上这样的文件头--- title: 需求评审 updated: 2026-08-01T14:55:00 created: 2021-11-11T14:54:43 --- 正文内容……给 Joplin 用。格式选 2把OneNoteLinksHandling换成ConvertToMarkdownPanDocMarkdownFormat保持gfm。导出后在 Joplin 里选「文件 → 导入 → RAW - Joplin Export Directory」指向导出文件夹即可标签和层级都能对上。详细流程可参考项目里的doc/migration-to-joplin.md。一次性导出所有笔记本 / 定时备份。加个--all-notebooks参数它会忽略--notebook把所有笔记本挨个处理一遍OneNoteMdExporter.exe --all-notebooks --format 1 --no-input配合 Windows 任务计划程序定时执行这条命令等于给整个笔记库做了一个可持续的 Markdown 备份。如果只想导出某个分区或某页还可以追加--section 分区名和--page 页面名精确控制范围。出发前收好这份行动清单克隆仓库按上文把pandoc.exe解压就位先拿一个最常用的小笔记本试跑全程开着 OneNote 等它同步完成对照appSettings.json里的配置项按你要去的平台Obsidian 还是 Joplin调好链接策略导出完成后随机抽查十几篇带表格、图片的笔记确认质量遇到报错先看同目录下的logs.txt再带着日志去项目里提问或参与改进。知识迁移从来不是一夜之间的事但好消息是最痛苦的那一步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），仅供参考 一条命令把 OneNote 笔记完整导出成 Markdown：onenote-md-exporter 迁移 Obsidian 完整避坑指南
一条命令把 OneNote 笔记完整导出成 Markdownonenote-md-exporter 迁移 Obsidian 完整避坑指南【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter把攒了多年的 OneNote 笔记搬进 Obsidian最怕的不是内容多而是结构散、图片乱、链接失效。onenote-md-exporter 是一个在本地运行的命令行工具能把 OneNote 笔记本完整导出为 Markdown 格式适配 Obsidian、Joplin 等主流笔记软件。这篇指南从环境准备讲到进阶配置照着做你也能一次迁移成功。先别急着复制粘贴说说大多数人卡在哪试过的人都有体会OneNote 里的目录整整齐齐一导出就变成一摊平铺的文件正文里的图片路径全乱表格散架页面之间的互相引用也全部失效。手工复制粘贴要花好几个周末OneNote 自带的导出又几乎不可用在线转换工具还得把私人笔记传到别人服务器上——光是想想就劝退。如果你也卡在这个死胡同里下面这个本地工具值得花十分钟试一次。它凭什么能导出后几乎不用改三个关键设计第一数据从头到尾不出你的电脑。工具直接调用本机安装的 OneNote 和 Word官方 COM 接口读取原始内容全程离线不依赖任何云端服务。对存着客户资料、私人日记的笔记本来说这是最让人安心的部分。第二笔记本的骨架被完整保留。分区变成文件夹分区组变成嵌套目录子页面默认作为父页面的下级文件夹。导出的目录树和你在 OneNote 里看到的结构几乎一一对应而不是把所有页面哗啦一下倒进同一个文件夹。第三它天生就是为 Obsidian、Joplin 这类 Markdown 编辑器设计的。内部链接可以转成[[双链]]格式每篇笔记自动带上带创建时间、更新时间的 Front Matter 头还内置 Pandoc 转换引擎兜底复杂表格和格式。它的转换管线也很扎实先通过 OneNote COM 接口把每页内容导出成 DocX再用 Pandoc 把 DocX 翻译成 Markdown最后跑一轮正则后处理修复格式毛刺。这种双引擎 后处理的思路比任何单步转换都稳妥。一张表看清四种迁移方式迁移方式层级结构内部链接图片附件是否安全手工复制粘贴丢失失效丢失安全OneNote 自带导出扁平化失效可用安全在线转换网站扁平化失效看运气需上传云端onenote-md-exporter完整保留转为双链完整保留全程本地从下载到导出照着做就行动手之前先确认三件事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它会列出本机所有笔记本让你勾选要导出的对象、选择格式1 是 Markdown2 是 Joplin 原始目录格式还能现场调整高级设置。等它跑完会自动弹出导出文件夹。想要批量或无人值守用命令行一次指定笔记本和格式OneNoteMdExporter.exe --notebook 我的笔记本 --format 1 --no-input导出完成后你会得到类似这样的目录结构我的笔记本/ ├─ 工作项目/ │ ├─ 需求文档/ │ │ ├─ 需求评审.md │ │ └─ 技术方案.md │ └─ 周报.md ├─ 生活随笔.md └─ resources/ ├─ 截图1.png └─ 附件.pdf页面是.md文件图片和附件统一收在resources文件夹里Markdown 内部用相对路径引用。放进 Obsidian 仓库就能直接用不需要再改任何路径。第一次运行必踩的坑现象、原因、解法启动就报System.Runtime.InteropServices.COMException这通常是程序没能和 OneNote 组件握手常见原因是本机 Office 安装有问题。最省事的解法不是重装 Office而是按doc/notebook-onepkg-export.md里的说明把笔记本导出成.onepkg包换一台干净的电脑导入后再导出 Markdown——效果一样风险更低。导出后图片是坏的多半是 OneNote 本地根本没缓存图片。到「文件 → 选项 → 同步」里勾上下载所有文件和图像强制同步一次再重新导出基本就能解决。密码保护的分区变空了记得在导出前手动解锁锁着的分区内容不会进入结果。手写笔迹直接消失这是工具明确的边界手写内容不支持转换导出前心里要有数。文件名太长导致路径超限笔记本里有标题超长的页面时可以在配置里把MdMaxFileLength调小一点从源头避免 Windows 路径过长的报错。如果还是找不到原因导出目录下会生成一份logs.txt日志带着它去项目里提问能省下大量来回沟通的时间。进阶三组配置组合按你的目标平台直接抄工具的高级设置都集中在appSettings.json里用记事本打开就能改。下面是三组经过验证的组合给 Obsidian 用默认组合基本不用动。把OneNoteLinksHandling设为ConvertToWikilinkOneNote 内部链接变成[[双链]]双向链接直接可用ProcessingOfPageHierarchy保持HierarchyAsFolderTree层级就是文件夹AddFrontMatterHeader设为true每篇笔记自动带上创建/更新时间方便检索。导出的每篇笔记都会带上这样的文件头--- title: 需求评审 updated: 2026-08-01T14:55:00 created: 2021-11-11T14:54:43 --- 正文内容……给 Joplin 用。格式选 2把OneNoteLinksHandling换成ConvertToMarkdownPanDocMarkdownFormat保持gfm。导出后在 Joplin 里选「文件 → 导入 → RAW - Joplin Export Directory」指向导出文件夹即可标签和层级都能对上。详细流程可参考项目里的doc/migration-to-joplin.md。一次性导出所有笔记本 / 定时备份。加个--all-notebooks参数它会忽略--notebook把所有笔记本挨个处理一遍OneNoteMdExporter.exe --all-notebooks --format 1 --no-input配合 Windows 任务计划程序定时执行这条命令等于给整个笔记库做了一个可持续的 Markdown 备份。如果只想导出某个分区或某页还可以追加--section 分区名和--page 页面名精确控制范围。出发前收好这份行动清单克隆仓库按上文把pandoc.exe解压就位先拿一个最常用的小笔记本试跑全程开着 OneNote 等它同步完成对照appSettings.json里的配置项按你要去的平台Obsidian 还是 Joplin调好链接策略导出完成后随机抽查十几篇带表格、图片的笔记确认质量遇到报错先看同目录下的logs.txt再带着日志去项目里提问或参与改进。知识迁移从来不是一夜之间的事但好消息是最痛苦的那一步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），仅供参考