如何将OneNote完美迁移到Markdown：终极免费导出指南

如何将OneNote完美迁移到Markdown：终极免费导出指南

【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter

你是否曾经为OneNote笔记的格式锁定而烦恼？看着多年积累的知识库，想要迁移到Obsidian或Joplin这样的现代笔记工具，却被复杂的格式转换和附件处理劝退？今天我要分享一个强大的解决方案——OneNote Md Exporter，它能帮你轻松实现OneNote到Markdown的无缝转换。

为什么你需要专业的OneNote导出工具

传统的复制粘贴方法在处理OneNote笔记时总是力不从心：表格变形、图片丢失、层级结构混乱。这款开源工具直接调用OneNote API，保留了原始笔记的完整结构和格式，让你真正实现知识库的自由迁移。

核心功能亮点：

• ✅完整层级保留：笔记本→分区→页面→子页面的完整结构
• ✅格式智能转换：富文本、表格、颜色标注自动转为Markdown语法
• ✅附件批量处理：图片、文件自动导出并保持链接关系
• ✅内部链接维护：OneNote内部链接转换为相对路径或WikiLink格式

快速开始：三步完成首次导出

第一步：环境准备

确保你的系统满足以下要求：

• Windows 10/11操作系统
• OneNote 2013或更高桌面版（⚠️ 不支持Windows商店版本）
• Word 2013或更高版本（用于格式转换支持）

第二步：获取工具

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter

2. 或直接下载最新发布版本
3. 解压到任意目录（建议路径不含中文和空格）

第三步：执行导出

启动OneNote并确保要导出的笔记本已加载，然后运行：

OneNoteMdExporter.exe

程序会自动列出所有可用的笔记本，使用方向键选择并按Enter确认即可开始导出。

高级配置：定制你的导出方案

命令行参数详解

对于批量处理或自动化工作流，命令行模式更加灵活：

OneNoteMdExporter.exe --notebook "工作笔记" --format markdown --output "D:\笔记备份"

常用参数说明：

配置文件深度定制

修改程序目录下的appSettings.json文件可以实现更精细的控制：

{ "ResourceFolderLocation": "Relative", "IndentingStyle": "TwoSpaces", "OneNoteLinksHandling": "ConvertToWikilink", "AddFrontMatterHeader": true }

关键配置说明：

• ResourceFolderLocation：附件保存位置策略

  • Relative：在每个.md文件旁创建附件文件夹
  • Absolute：在导出根目录统一存放所有附件

• OneNoteLinksHandling：OneNote内部链接处理策略

  • KeepOriginal：保留原始onenote://链接
  • ConvertToMarkdown：转换为标准Markdown链接
  • ConvertToWikilink：转换为WikiLink格式（推荐）
  • Remove：移除所有OneNote链接

格式支持对比：Markdown vs Joplin

了解不同导出格式的特点，选择最适合你的方案：

*注：跨笔记本链接和分区链接会被移除

实战技巧：解决常见导出难题

学术笔记完美导出

对于包含数学公式和复杂图表的学术笔记，启用Pandoc支持可以获得更好的效果：

OneNoteMdExporter.exe --notebook "研究笔记" --pandoc true

确保已解压pandoc到程序目录的pandoc文件夹中，这样公式会被正确转换为LaTeX格式。

批量导出多个笔记本

创建批处理文件实现自动化批量导出：

@echo off echo 开始批量导出OneNote笔记本... OneNoteMdExporter.exe --notebook "项目文档" --output "D:\备份\项目" OneNoteMdExporter.exe --notebook "会议记录" --output "D:\备份\会议" OneNoteMdExporter.exe --notebook "个人笔记" --output "D:\备份\个人" echo 所有笔记本导出完成！ pause

处理复杂表格和格式

OneNote中的复杂表格和特殊格式会被转换为HTML，确保你的Markdown编辑器支持HTML渲染。如果遇到问题，可以调整以下设置：

{ "UseHtmlStyling": true, "PanDocMarkdownFormat": "gfm" }

常见问题解答（FAQ）

Q: 程序启动时报错"System.Runtime.InteropServices.COMException"

A: 这通常是由于Office安装问题导致的。尝试：

1. 重新安装Office套件
2. 从其他电脑导出笔记本（参考官方文档中的笔记本导出方法）
3. 确保OneNote桌面版已完全启动

Q: 导出后图片无法显示

A: 检查以下配置：

1. 确认导出目录下存在"attachments"文件夹
2. 检查图片路径是否为相对路径
3. 在OneNote中启用"下载所有文件和图片"选项（文件→选项→同步）

Q: 公式转换出现乱码

A: 确保：

1. Pandoc已正确解压到pandoc文件夹
2. 命令行中添加了--pandoc true参数
3. 使用最新版本的Pandoc

Q: 如何导出密码保护的分区？

A: 在导出前需要先解锁密码保护的分区，否则这些分区的内容将无法导出。

进一步探索

自定义转换规则

如果你有特殊的格式转换需求，可以研究项目的源码结构：

• 转换服务核心：src/OneNoteMdExporter/Services/ConverterService.cs
• Markdown导出实现：src/OneNoteMdExporter/Services/Export/MdExportService.cs
• Joplin格式支持：src/OneNoteMdExporter/Services/Export/JoplinExportService.cs

多语言支持

项目内置了多语言资源文件，支持英语、法语、西班牙语和中文：

• src/OneNoteMdExporter/Resources/trad.zh.json

测试和验证

使用项目提供的测试笔记本验证导出效果：

• sample/TestNotebook.onepkg

开始你的迁移之旅

现在你已经掌握了OneNote到Markdown迁移的完整方案。无论是要将工作笔记迁移到Obsidian，还是将个人知识库导入Joplin，这个工具都能帮你实现平滑过渡。

记住，知识管理工具应该为你服务，而不是束缚你。选择开放格式，让你的笔记真正属于你。

小贴士：首次导出前，建议先用测试笔记本验证效果。导出完成后，花几分钟检查关键页面，确保格式和链接都符合预期。这样的小投入能避免后续的大麻烦。

祝你迁移顺利！如果遇到问题，记得查阅项目文档和配置文件，大多数问题都能在配置中找到解决方案。

【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter