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 里躺着五六年甚至更久的笔记工作总结、读书笔记、项目文档、随手截图……一旦想换个工具最大的阻力不是操作麻烦而是搬过去会不会全乱套的担忧。onenote-md-exporter 正是冲着这个问题来的一款运行在 Windows 上的开源命令行工具能在本地直接把 OneNote 笔记本转换为 Markdown供 Obsidian、Joplin 等平台使用全程不经过任何云端格式还原度在同类方案里属于第一梯队。本文不打算罗列全部参数而是从三个最让用户纠结的问题出发带你走完一次完整的笔记迁移流程。问题一搬完家层级和格式还完整吗症状用另存为或在线工具导出后原本笔记本→分区→子分区→页面→子页面的多级结构被拍扁成一张清单表格错位、彩色文字消失、折叠段落全部展开。原因OneNote 把内容存在私有格式里普通导出手段只能捞到看得见的文本结构关系和样式细节基本带不走。解法onenote-md-exporter 采用一条特殊的转换链路——先用 OneNote 官方接口把每个页面读出来转成 DocX再借助 Pandoc 把 DocX 翻译成 Markdown前后还各有一道 XML 预处理和正则后处理来修复格式。在 Markdown 格式下分区和分区组默认导出为文件夹层级页面层级则给你两种选择HierarchyAsFolderTree默认父页面成为子页面的文件夹例如Section1/父页面/子页面.mdHierarchyAsPageTitlePrefix把父页面名作为子页面文件名前缀例如Section1/父页面_子页面.md至于内容本身能保到什么程度项目文档里有一张支持矩阵摘录几个关键项内容类型转换结果文本100% 保留简单表格转成 Markdown 表格复杂表格以 HTML 表格保留图片与附件原样保存文本标签任务、星标等转为对应表情符号手写笔迹无法保留密码保护分区需先在 OneNote 中解锁也就是说常规内容基本都能完好带走手写内容是目前唯一确定会丢失的类型迁移前最好先截图留档。问题二笔记之间的链接换平台还点得通吗症状在 OneNote 里精心维护的互链关系导出后全部变成onenote://开头的死链接点一下毫无反应。原因OneNote 内部链接走的是私有协议任何第三方编辑器都识别不了。解法设置项OneNoteLinksHandling直接决定链接的归宿共四种策略策略效果适合谁KeepOriginal保留原始 onenote:// 链接以后还可能回到 OneNoteConvertToMarkdown转成文字标准链接JoplinConvertToWikilink默认转成[[页面标题|显示文字]]双链Obsidian 等支持双链的软件Remove只保留链接文字删掉链接本身链接已无意义时需要提醒的是无论选哪种跨笔记本的链接和指向分区页的链接都会被移除这是格式本身的限制别等导出完才发现。问题三图片和附件会不会丢在迁移路上症状导出目录里图片缺了一大半或者引用路径全部失效。原因多数时候不是工具的问题而是 OneNote 云端根本没把图片下载到本地另外资源文件的存放方式也会影响 Markdown 里的引用路径。解法两步走。第一步打开 OneNote 的 文件→选项→同步勾选下载所有文件和图像强制同步一次再导出。第二步用ResourceFolderLocation决定资源放哪RootFolder默认所有图片和附件集中到导出根目录的 resources 文件夹适合图片多的笔记本也方便整体拷贝PageParentFolder资源放在各自 md 文件旁边结构最直观适合把单篇笔记单独分享的场景第一次导出从环境准备到出结果不到十分钟两步完成环境准备备齐三样软件Windows 10 及以上、OneNote 2013 及以上Windows 商店版不支持、Word 2013 及以上。项目基于 .NET 10 自包含发布通常不需要额外安装运行时。获取程序克隆仓库后把src/OneNoteMdExporter/pandoc/目录下的 pandoc 压缩包解开确保pandoc.exe就位git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter交互式导出跟着提示走启动OneNoteMdExporter.exe它会依次问你选哪个笔记本输 0 可全部导出、选哪种格式1 是 Markdown2 是 Joplin、要不要顺手改一下高级配置。确认后导出开始这段时间你可以去冲杯咖啡 ☕结束后程序会自动打开导出文件夹。命令行方式适合批量与自动化交互之外程序支持完整的命令行参数跑一次--help就能全部掌握。常用的几个# 导出指定笔记本为 Markdown格式 1 OneNoteMdExporter.exe --notebook 工作笔记 --format 1 # 导出全部笔记本不等待任何输入 OneNoteMdExporter.exe --all-notebooks --no-input # 只导出某个分区下的某个页面 OneNoteMdExporter.exe --notebook 工作笔记 --section 项目A --page 需求文档配合--ignore-errors可以在个别页面出错时继续导出剩余内容适合无人值守跑批。真实场景1200 篇技术笔记搬进 Obsidian一位后端工程师的笔记本里有 1200 篇技术笔记目标是整体迁入 Obsidian。他的做法是保持默认的HierarchyAsFolderTree让笔记本→分区→子页面的层级原样落地成文件夹开启AddFrontMatterHeader让每篇笔记带上前言元数据标题、创建与修改时间方便按日期检索链接策略选ConvertToWikilink笔记间的互链直接变成 Obsidian 双链反向链接面板立刻可用PanDocMarkdownFormat保持gfm语法与 Obsidian 完全兼容导出后按三件事验收文件夹层级是否与原笔记本一一对应、随机抽 10% 的页面核对表格与图片、再随便点开几条双链确认跳转正常。整个迁移都在本地完成没有任何内容经过网络这在处理含客户信息的笔记时格外重要。结合你的目标软件把配置调到最佳不同平台的脾气不一样这里给三套经过验证的组合目标平台关键配置ObsidianOneNoteLinksHandlingConvertToWikilinkAddFrontMatterHeadertruePanDocMarkdownFormatgfmJoplin直接选 Joplin 格式导出再通过 文件→导入→RAW - Joplin Export Directory 导入若用 Markdown 格式链接选ConvertToMarkdown通用 Markdown 编辑器若编辑器不支持 HTML把UseHtmlStyling关掉避免复杂表格和颜色样式渲染异常其他几个值得认识的参数PageTitleMaxLength和MdMaxFileLength控制文件名长度上限遇到路径过长报错时把它们调小即可IndentingStyle决定 OneNote 的缩进在 Markdown 里如何呈现默认保持原样也可以转成项目符号列表。三个常见的坑帮你提前避开坑一启动即报 COMException。这类错误通常是本机 Office 安装异常导致的。可以先尝试重装 Office更省事的办法是把笔记本导出为 .onepkg 文件见项目里的 doc/notebook-onepkg-export.md换一台干净的电脑导入后再导出。坑二导出后图片缺失。回到前面的问题三先确认 OneNote 已开启下载所有文件和图像并强制同步再重跑一遍导出。坑三文件名带特殊字符导致路径错误。用命令行时记得给笔记本名加引号如果报路径过长把MdMaxFileLength从 50 往下调。另外项目以 GPL v3 协议发布作者明确声明导出过程中存在丢失数据的可能动手前务必给 OneNote 笔记留一份备份——这比任何配置都重要。给迁移留个稳妥的节奏知识迁移不该是一天搬完的豪赌而是一次可以分步验证的过程。建议先用仓库里的sample/TestNotebook.onepkg试跑一遍把配置和流程跑通再挑一个你最看重的笔记本正式导出确认效果后逐步扩大范围。如果你用下来发现问题或者想帮忙完善多语言翻译中文本地化文件就在src/OneNoteMdExporter/Resources/目录下项目的 doc/contribute.md 写清了贡献方式。从第一本笔记本开始你的知识资产就离可检索、可迁移、不过期的 Markdown 更近一步了。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
