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 里的几年笔记无损迁移到 Markdown 平台开源工具 onenote-md-exporter 能帮你一次搞定。它借助官方 COM 接口与 Pandoc 转换引擎把整本笔记本导出为通用 Markdown链接、层级与附件一并保留。下面这份通关手册就是为你的第一次迁移准备的。为什么 OneNote 的笔记总是进得来、出不去想象一个场景你把一篇写了两年的项目复盘从 OneNote 复制到新笔记软件里。标题回来了表格却散了架图片丢了位置页面之间的链接变成一串毫无意义的onenote://地址。这不是你操作不当而是 OneNote 的格式天然封闭——它擅长把内容装进自己的盒子却很少考虑怎么让人体面地搬走。如果你遇到过下面任何一条你就是本文的读者想试试 Obsidian、Logseq 的双链笔记却被迁移成本挡在门外想给多年的笔记做一份开放格式的长期备份团队要整体撤离 OneNote批量搬走上千页文档用过在线转换工具却担心笔记内容经手第三方服务器onenote-md-exporter 正是冲着这些场景来的。它是一款运行在 Windows 上的开源工具把 OneNote 笔记本完整导出为 Markdown让你在 Obsidian、Joplin 以及任何支持 Markdown 的编辑器里继续使用这些内容。笔记无损迁移的底气双引擎如何保住格式与结构迁移之所以容易翻车是因为读出来和转格式是两件完全不同的事。这个工具把两件事拆开分别交给两套引擎提取引擎Interop API直接与 OneNote、Word 的官方 COM 接口通信。这一步不经过任何中间人页面内容、图片、附件都能原样落盘。转换引擎Pandoc先把页面发布成 DocX再交给 Pandoc 这个文档转换界的标准件翻译成 Markdown复杂表格、段落样式都能被正确识别。在两套引擎之间还夹着两道工序导出前会先对 OneNote 的页面 XML 做预处理展开折叠段落、把标签转成符号导出后再用正则做一轮后处理修正 Pandoc 产生的格式瑕疵。整条流水线都在本地运行不依赖微软云也不经过任何第三方服务器。想了解实现细节可以翻阅源码目录 src/OneNoteMdExporter/。一句话概括这套流水线的能力边界内容类型转换结果分区与分区组保留为文件夹层级页面层级保留为子文件夹或文件名前缀页面内链接按策略转为普通链接或双链图片与文件附件完整保留并重新引用简单表格转为标准 Markdown 表格复杂表格、字体/背景颜色转为 HTML 保留需编辑器支持任务、星标等文本标签转为对应 emoji折叠段落自动展开绘图内容扁平化为图片手写笔迹无法导出建议提前截图保存密码保护分区需先解锁否则内容丢失迁移前检查清单三项准备五分钟搞定出发前先花五分钟核对下面的清单能帮你避开九成的问题系统为 Windows 10 及以上版本安装 OneNote 2013 或更高版本注意Windows 商店版不支持请使用桌面版安装 Word 2013 或更高版本打开 OneNote确认要导出的笔记本已完整加载、同步完成工具本身是自包含的 .NET 应用解压即用不需要另外安装运行时。第一次迁移建议先用官方示例笔记本练手sample/TestNotebook.onepkg跑通完整流程再对真实数据动手。从安装到OneNote批量导出Markdown交互界面与命令行双通道获取工具的方式很简单git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter把压缩包解压后直接双击OneNoteMdExporter.exe就能进入交互界面。整套流程只有四步从列表中选择要导出的笔记本输入编号可多选输入 0 导出全部选择导出格式1为 Markdown 文件夹2为 Joplin 专用目录按需决定是否修改高级设置会调用记事本打开配置文件等待导出完成工具会自动打开资源管理器定位到导出文件夹导出结果会以笔记本名 时间戳命名存放在工具目录下的导出文件夹中方便你多次导出做对比。习惯命令行的朋友也可以全程用参数驱动# 查看全部命令行参数 OneNoteMdExporter.exe --help # 导出指定笔记本为 Markdown 格式 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 # 导出为 Joplin 格式 OneNoteMdExporter.exe --notebook 学习资料 --format 2 # 只导出某个分区需配合 --notebook OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --section 阅读笔记 # 一次导出所有笔记本 OneNoteMdExporter.exe --all-notebooks --format 1 # 无人值守模式不等待任何输入 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --no-inputOneNote导出Obsidian与Joplin三套开箱即用的差异化配置同一份笔记迁到 Obsidian 和迁到 Joplin 的最优解并不相同。所有开关都集中在配置文件 src/OneNoteMdExporter/appSettings.json 里改完重启工具即生效。开工前先认识四个关键旋钮旋钮一内部链接怎么处理OneNoteLinksHandling取值效果适合谁KeepOriginal保留原始onenote://链接可能回迁 OneNote 的用户ConvertToMarkdown转为文字Joplin、通用编辑器ConvertToWikilink转为[[页面|文字]]双链Obsidian、LogseqRemove移除链接、只留文字追求干净输出的用户旋钮二页面层级怎么落地ProcessingOfPageHierarchyHierarchyAsFolderTree父页面变成子文件夹最贴近 OneNote 原貌HierarchyAsPageTitlePrefix父子关系写进文件名适合扁平化场景IgnoreHierarchy忽略层级所有页面平铺在分区下旋钮三图片附件放哪里ResourceFolderLocationRootFolder全部集中在导出根目录的resources文件夹便于整体备份PageParentFolder每个页面旁边各放一份方便单独移动、分享单页旋钮四Markdown 方言PanDocMarkdownFormat默认的gfm是通用性最好的选择commonmark更严格如果你的编辑器支持 HTML还可以在gfmraw_html基础上配合UseHtmlStyling保留字体颜色等样式。下面是三套可以直接照抄的配置。Obsidian 用户用双链和文件夹结构还原你的知识网络{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: PageParentFolder, OneNoteLinksHandling: ConvertToWikilink, AddFrontMatterHeader: true, PanDocMarkdownFormat: gfmraw_html, UseHtmlStyling: true }Joplin 用户用专用目录格式保留分区与页面顺序{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: ConvertToMarkdown, AddFrontMatterHeader: true, PanDocMarkdownFormat: gfm, PostProcessingMdImgRef: true }导出后进入 Joplin点击文件 → 导入 → RAW - Joplin 导出目录即可完成导入更详细的说明见 doc/migration-to-joplin.md。通用 Markdown 编辑器怎么简单怎么来{ ProcessingOfPageHierarchy: IgnoreHierarchy, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: Remove, AddFrontMatterHeader: false, PanDocMarkdownFormat: commonmark, UseHtmlStyling: false }另外打开AddFrontMatterHeader后每个页面开头会生成一段 YAML 元数据记录标题与创建、更新时间方便目标平台做检索与排序。笔记迁移常见问题三个暗礁与提速技巧暗礁一启动时报 COMExceptionSystem.Runtime.InteropServices.COMException通常意味着工具没能连上 OneNote 进程多半是 Office 安装或登录状态出了问题。按顺序试这三招完整退出 OneNote 后重新打开确认已登录 Microsoft 账户修复 Office 安装控制面板 → 更改 → 联机修复在另一台电脑上导入笔记本再导出先在原机把笔记本另存为.onepkg包操作步骤见 doc/notebook-onepkg-export.md暗礁二导出后图片显示为裂图先检查导出目录里resources文件夹是否存在、Markdown 里的引用路径是否正确。如果文件确实缺失多半是 OneNote 本地缓存不完整——打开 OneNote 的文件 → 选项 → 同步开启下载所有文件和图像强制同步后再导一次。暗礁三大笔记本导出到一半卡住上千页的笔记本对接口调用和磁盘 IO 都是考验。三个提速姿势按分区分批导出用--section 分区名逐个处理最后合并结果导出时挂上--ignore-errors个别页面出错不会中断整体任务把工具和导出目录放在 SSD 上同时关掉不必要的后台程序想批量处理多个笔记本也可以写一段简单的 PowerShell 循环$notebooks (工作笔记, 学习资料, 项目文档) foreach ($name in $notebooks) { Write-Host 正在导出$name .\OneNoteMdExporter.exe --notebook $name --format 1 --no-input }验收清单与下一步让迁移真正落地导出完成后花三分钟做一次验收但别急着删原数据抽查 3 到 5 个页面确认正文、表格、图片完整点击几个页面间链接确认跳转正常打开附件目录核对文件数量与页面中的引用一致保留 OneNote 原笔记本至少一个月作为兜底迁移的意义不只是换一个软件笔记从专有格式变成开放的 Markdown意味着它从此真正属于你——想搬去哪个平台、想怎么检索、想备份多少份都由你说了算。挑一个空闲的下午备份好 OneNote 数据按这份手册跑通第一次导出。等你在新编辑器里打开第一页笔记你会发现这场搬家比想象中轻松得多。【免费下载链接】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一次搞定笔记无损迁移
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 里的几年笔记无损迁移到 Markdown 平台开源工具 onenote-md-exporter 能帮你一次搞定。它借助官方 COM 接口与 Pandoc 转换引擎把整本笔记本导出为通用 Markdown链接、层级与附件一并保留。下面这份通关手册就是为你的第一次迁移准备的。为什么 OneNote 的笔记总是进得来、出不去想象一个场景你把一篇写了两年的项目复盘从 OneNote 复制到新笔记软件里。标题回来了表格却散了架图片丢了位置页面之间的链接变成一串毫无意义的onenote://地址。这不是你操作不当而是 OneNote 的格式天然封闭——它擅长把内容装进自己的盒子却很少考虑怎么让人体面地搬走。如果你遇到过下面任何一条你就是本文的读者想试试 Obsidian、Logseq 的双链笔记却被迁移成本挡在门外想给多年的笔记做一份开放格式的长期备份团队要整体撤离 OneNote批量搬走上千页文档用过在线转换工具却担心笔记内容经手第三方服务器onenote-md-exporter 正是冲着这些场景来的。它是一款运行在 Windows 上的开源工具把 OneNote 笔记本完整导出为 Markdown让你在 Obsidian、Joplin 以及任何支持 Markdown 的编辑器里继续使用这些内容。笔记无损迁移的底气双引擎如何保住格式与结构迁移之所以容易翻车是因为读出来和转格式是两件完全不同的事。这个工具把两件事拆开分别交给两套引擎提取引擎Interop API直接与 OneNote、Word 的官方 COM 接口通信。这一步不经过任何中间人页面内容、图片、附件都能原样落盘。转换引擎Pandoc先把页面发布成 DocX再交给 Pandoc 这个文档转换界的标准件翻译成 Markdown复杂表格、段落样式都能被正确识别。在两套引擎之间还夹着两道工序导出前会先对 OneNote 的页面 XML 做预处理展开折叠段落、把标签转成符号导出后再用正则做一轮后处理修正 Pandoc 产生的格式瑕疵。整条流水线都在本地运行不依赖微软云也不经过任何第三方服务器。想了解实现细节可以翻阅源码目录 src/OneNoteMdExporter/。一句话概括这套流水线的能力边界内容类型转换结果分区与分区组保留为文件夹层级页面层级保留为子文件夹或文件名前缀页面内链接按策略转为普通链接或双链图片与文件附件完整保留并重新引用简单表格转为标准 Markdown 表格复杂表格、字体/背景颜色转为 HTML 保留需编辑器支持任务、星标等文本标签转为对应 emoji折叠段落自动展开绘图内容扁平化为图片手写笔迹无法导出建议提前截图保存密码保护分区需先解锁否则内容丢失迁移前检查清单三项准备五分钟搞定出发前先花五分钟核对下面的清单能帮你避开九成的问题系统为 Windows 10 及以上版本安装 OneNote 2013 或更高版本注意Windows 商店版不支持请使用桌面版安装 Word 2013 或更高版本打开 OneNote确认要导出的笔记本已完整加载、同步完成工具本身是自包含的 .NET 应用解压即用不需要另外安装运行时。第一次迁移建议先用官方示例笔记本练手sample/TestNotebook.onepkg跑通完整流程再对真实数据动手。从安装到OneNote批量导出Markdown交互界面与命令行双通道获取工具的方式很简单git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter把压缩包解压后直接双击OneNoteMdExporter.exe就能进入交互界面。整套流程只有四步从列表中选择要导出的笔记本输入编号可多选输入 0 导出全部选择导出格式1为 Markdown 文件夹2为 Joplin 专用目录按需决定是否修改高级设置会调用记事本打开配置文件等待导出完成工具会自动打开资源管理器定位到导出文件夹导出结果会以笔记本名 时间戳命名存放在工具目录下的导出文件夹中方便你多次导出做对比。习惯命令行的朋友也可以全程用参数驱动# 查看全部命令行参数 OneNoteMdExporter.exe --help # 导出指定笔记本为 Markdown 格式 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 # 导出为 Joplin 格式 OneNoteMdExporter.exe --notebook 学习资料 --format 2 # 只导出某个分区需配合 --notebook OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --section 阅读笔记 # 一次导出所有笔记本 OneNoteMdExporter.exe --all-notebooks --format 1 # 无人值守模式不等待任何输入 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 --no-inputOneNote导出Obsidian与Joplin三套开箱即用的差异化配置同一份笔记迁到 Obsidian 和迁到 Joplin 的最优解并不相同。所有开关都集中在配置文件 src/OneNoteMdExporter/appSettings.json 里改完重启工具即生效。开工前先认识四个关键旋钮旋钮一内部链接怎么处理OneNoteLinksHandling取值效果适合谁KeepOriginal保留原始onenote://链接可能回迁 OneNote 的用户ConvertToMarkdown转为文字Joplin、通用编辑器ConvertToWikilink转为[[页面|文字]]双链Obsidian、LogseqRemove移除链接、只留文字追求干净输出的用户旋钮二页面层级怎么落地ProcessingOfPageHierarchyHierarchyAsFolderTree父页面变成子文件夹最贴近 OneNote 原貌HierarchyAsPageTitlePrefix父子关系写进文件名适合扁平化场景IgnoreHierarchy忽略层级所有页面平铺在分区下旋钮三图片附件放哪里ResourceFolderLocationRootFolder全部集中在导出根目录的resources文件夹便于整体备份PageParentFolder每个页面旁边各放一份方便单独移动、分享单页旋钮四Markdown 方言PanDocMarkdownFormat默认的gfm是通用性最好的选择commonmark更严格如果你的编辑器支持 HTML还可以在gfmraw_html基础上配合UseHtmlStyling保留字体颜色等样式。下面是三套可以直接照抄的配置。Obsidian 用户用双链和文件夹结构还原你的知识网络{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: PageParentFolder, OneNoteLinksHandling: ConvertToWikilink, AddFrontMatterHeader: true, PanDocMarkdownFormat: gfmraw_html, UseHtmlStyling: true }Joplin 用户用专用目录格式保留分区与页面顺序{ ProcessingOfPageHierarchy: HierarchyAsFolderTree, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: ConvertToMarkdown, AddFrontMatterHeader: true, PanDocMarkdownFormat: gfm, PostProcessingMdImgRef: true }导出后进入 Joplin点击文件 → 导入 → RAW - Joplin 导出目录即可完成导入更详细的说明见 doc/migration-to-joplin.md。通用 Markdown 编辑器怎么简单怎么来{ ProcessingOfPageHierarchy: IgnoreHierarchy, ResourceFolderLocation: RootFolder, OneNoteLinksHandling: Remove, AddFrontMatterHeader: false, PanDocMarkdownFormat: commonmark, UseHtmlStyling: false }另外打开AddFrontMatterHeader后每个页面开头会生成一段 YAML 元数据记录标题与创建、更新时间方便目标平台做检索与排序。笔记迁移常见问题三个暗礁与提速技巧暗礁一启动时报 COMExceptionSystem.Runtime.InteropServices.COMException通常意味着工具没能连上 OneNote 进程多半是 Office 安装或登录状态出了问题。按顺序试这三招完整退出 OneNote 后重新打开确认已登录 Microsoft 账户修复 Office 安装控制面板 → 更改 → 联机修复在另一台电脑上导入笔记本再导出先在原机把笔记本另存为.onepkg包操作步骤见 doc/notebook-onepkg-export.md暗礁二导出后图片显示为裂图先检查导出目录里resources文件夹是否存在、Markdown 里的引用路径是否正确。如果文件确实缺失多半是 OneNote 本地缓存不完整——打开 OneNote 的文件 → 选项 → 同步开启下载所有文件和图像强制同步后再导一次。暗礁三大笔记本导出到一半卡住上千页的笔记本对接口调用和磁盘 IO 都是考验。三个提速姿势按分区分批导出用--section 分区名逐个处理最后合并结果导出时挂上--ignore-errors个别页面出错不会中断整体任务把工具和导出目录放在 SSD 上同时关掉不必要的后台程序想批量处理多个笔记本也可以写一段简单的 PowerShell 循环$notebooks (工作笔记, 学习资料, 项目文档) foreach ($name in $notebooks) { Write-Host 正在导出$name .\OneNoteMdExporter.exe --notebook $name --format 1 --no-input }验收清单与下一步让迁移真正落地导出完成后花三分钟做一次验收但别急着删原数据抽查 3 到 5 个页面确认正文、表格、图片完整点击几个页面间链接确认跳转正常打开附件目录核对文件数量与页面中的引用一致保留 OneNote 原笔记本至少一个月作为兜底迁移的意义不只是换一个软件笔记从专有格式变成开放的 Markdown意味着它从此真正属于你——想搬去哪个平台、想怎么检索、想备份多少份都由你说了算。挑一个空闲的下午备份好 OneNote 数据按这份手册跑通第一次导出。等你在新编辑器里打开第一页笔记你会发现这场搬家比想象中轻松得多。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考