OneNote 笔记搬家到 Markdown：用 onenote-md-exporter 一劳永逸的完整教程

OneNote 笔记搬家到 Markdown用 onenote-md-exporter 一劳永逸的完整教程【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter你有没有算过自己往 OneNote 里存了多少年的笔记分区几十个、页面上千张图片、表格、待办事项、双链全混在一起。某天你想换个笔记软件——Obsidian、Joplin 或者 Typora——却发现导出这件事几乎无从下手。手动复制粘贴格式全崩在线转换工具隐私没保障PDF 批量导出层级和链接又全丢了。onenote-md-exporter 正是为这个场景而生的开源命令行工具它运行在 Windows 上通过调用 OneNote 与 Word 的官方 COM 接口把整个笔记本转换成标准 Markdown 或 Joplin 原生格式整个过程完全在本地完成不经过任何云端服务器。本文会带你从零开始走完准备 → 首次导出 → 按需定制 → 排查报错的全流程。先确认三件事你的环境能不能跑起来这个工具依赖 Windows 生态动手前先对照这张清单自查检查项要求说明操作系统Windows 10 及以上需要桌面版系统OneNote2013 或更高版本商店版Microsoft Store 安装不支持Microsoft Word2013 或更高版本用于将页面导出为 DocX 中间格式.NET 运行时.NET 6 及以上新版 release 已打包一般无需手动装还有一条容易被忽略的前提导出前先把 OneNote 打开并让目标笔记本完整同步到本地。工具通过 COM 接口与正在运行的 OneNote 实例通信笔记本没加载完导出结果就会缺页漏图。十分钟跑通第一次导出从选笔记本到喝咖啡工具的使用路径非常直白不需要写任何代码从 Releases 页面下载OneNoteMdExporter压缩包并解压启动 OneNote确认要导出的笔记本已经全部加载双击运行OneNoteMdExporter.exe按提示输入笔记本编号、选择导出格式1为 Markdown 文件夹2为 Joplin 目录按提示选择是否修改高级设置然后回车确认开始导出期间页面会逐条滚动进度完成后工具会自动用资源管理器打开导出文件夹。喜欢命令行操作的话所有参数都有对应选项运行OneNoteMdExporter.exe --help即可查看全部说明。几个高频用法示例# 导出指定笔记本为 Markdown 格式 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --output D:\笔记备份 # 导出为 Joplin 导入格式 OneNoteMdExporter.exe --notebook 学习资料 --format 2 --output D:\Joplin导入 # 一键导出全部笔记本跳过所有交互输入 OneNoteMdExporter.exe --all-notebooks --no-input需要批量处理多个笔记本时可以把命令包进 PowerShell 循环里导出后用文件数量做一次简单校验foreach ($nb in (工作笔记, 学习资料)) { .\OneNoteMdExporter.exe --notebook $nb --format 1 --output D:\导出\$nb $count (Get-ChildItem D:\导出\$nb -Recurse -Filter *.md).Count Write-Host $nb 导出完成共 $count 个 Markdown 文件 }三种输出骨架怎么选文件夹、前缀还是扁平化每个笔记本里的分区 → 父页面 → 子页面层级导出成文件后有很多种落盘方式。工具的ProcessingOfPageHierarchy参数提供了三种策略效果差异见下表策略文件结构示例适合谁HierarchyAsFolderTree默认分区/父页面/子页面.mdObsidian 等支持多级文件夹的笔记库HierarchyAsPageTitlePrefix分区/父页面_子页面.md想保留层级、又不希望目录过深的用户IgnoreHierarchy分区/子页面.md层级无所谓、只要内容干净的用户顺带一提同分区里重名的页面会自动加后缀避免覆盖你不用自己操心文件名冲突。链接、图片和附件四个开关决定迁移完整度OneNote 内部用onenote://协议互链直接搬到别的软件里全变死链。工具用OneNoteLinksHandling一个参数管住所有情况KeepOriginal原样保留onenote://链接适合未来可能回迁 OneNote 的场景ConvertToMarkdown转成文字标准 Markdown 通用写法ConvertToWikilink默认转成[[路径|显示文字]]Obsidian、Logseq 这类双链笔记的最爱Remove只保留链接文字、删掉链接本身适合彻底告别旧链接的场景。图片和附件文件的位置由ResourceFolderLocation控制选RootFolder会把所有资源集中在导出根目录下的一个resources文件夹选PageParentFolder则让资源紧挨着各自的 Markdown 文件存放方便整目录搬迁和共享。内容还原度盘点哪些保得住哪些会丢用之前最好先了解这个工具的能力边界心里有数才不会期望落空内容类型还原结果备注简单表格✅ 转为 Markdown 表格效果最好复杂表格✅ 转为 HTML 表格需要编辑器支持 HTML图片 / 文件附件✅ 完整保留相对路径自动生成折叠段落✅ 自动展开字体颜色 / 背景色✅ 转为 HTML 样式Obsidian、Joplin 均支持文本标签星标、旗帜等✅ 转为 emoji绘图内容⚠️ 压平成图片保留视觉但不保留矢量密码保护分区⚠️ 需先解锁否则直接丢失手写笔迹❌ 无法还原建议导出前手动截图针对 Obsidian 和 Joplin 的两套推荐配置工具根目录下的appSettings.json是唯一的配置文件导出时按提示输入y会用记事本打开它。以下两套配置分别对应两大热门平台可直接复制使用。Obsidian 专用强调双链与文件就近管理{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: PageParentFolder, OneNoteLinksHandling: ConvertToWikilink, AddFrontMatterHeader: true, UseHtmlStyling: true, PanDocMarkdownFormat: gfmraw_html }导出后把整个文件夹复制进 Obsidian 库刷新文件列表即可开启 Front Matter 后每个文件头部会附带title、created、updated三类 YAML 元数据供 Obsidian 的 Dataview 等插件直接读取。Joplin 专用直接走官方导入通道{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: ConvertToMarkdown, PanDocMarkdownFormat: gfm, PostProcessingMdImgRef: true }用2号格式导出后打开 Joplin依次点击文件 → 导入 → RAW - Joplin 导出目录选中导出文件夹即可完成导入。相比先转 ENEX 再导入的传统路线这套方案能完整保留分区层级和页面顺序。报错排查清单三个高频问题一次讲清① 启动即报System.Runtime.InteropServices.COMException说明工具没能连上 OneNote COM 组件。依次排查OneNote 是否已打开并登录账户 → Office 安装是否完整必要时修复重装→ 是否用了商店版 OneNote不支持。最稳妥的替代方案是在别的电脑上把笔记本导出为.onepkg包再导入后运行工具。② 导出后图片缺失或显示为裂图绝大多数情况下是 OneNote 本地缓存没同步完整。在 OneNote 的文件 → 选项 → 同步里打开下载所有文件和图像强制同步后再导出一次问题通常消失。③ 大笔记本导出特别慢工具是逐页调 Word 再调 Pandoc 转换的页面越多耗时越长。缓解办法用--section参数按分区分批导出、把目标目录放到 SSD 上、导出时关掉占用资源的后台程序。工具自带了失败页面自动重试机制如果 RPC 断连会等待 10 秒重建连接后再试一次无需人工干预。最后一步给自己留条后路迁移不是终点而是知识管理方式的一次升级。建议你先挑一个非核心笔记本跑一遍完整流程感受一下导出效果再决定要不要全量迁移正式迁移前务必给原始 OneNote 笔记本留好备份工具本身也在文档里明确提醒过不承担数据丢失责任。导出完成后你还可以顺手做三件锦上添花的事把 OneNote 标签批量映射成目标平台的标签、用正则修一遍历史文章里的格式瑕疵、把 Front Matter 里的时间字段同步到新笔记系统——从此你的笔记不再被锁定在微软的围墙花园里。挑一个周末下午备份好数据跑一次导出试试看。你会发现通往更开放笔记生态的路其实只有这一条命令的距离。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考