用onenote-md-exporter一次导出保住300页笔记的格式与层级【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter周五下午我盯着OneNote里那个攒了五年、整整300页的工作笔记本发愁公司要求把所有资料迁到Obsidian可手动复制粘贴试了几页就放弃了——表格变形、层级扁平、图片全部错位。直到同事递给我一个叫onenote-md-exporter的Windows命令行工具它专门解决把OneNote笔记本完整导出为Markdown这件事。如果你也正为笔记迁移发愁这篇文章会带你完整走一遍从安装到批量自动化的全过程。第一次导出从双击exe到喝上咖啡安装前的三件事onenote-md-exporter 是个Windows控制台程序运行前提很朴素Windows 10以上、OneNote 2013以上注意Windows商店版不支持得用桌面版、Word 2013以上。它之所以需要Office是因为底层直接调用OneNote和Word的官方COM接口来读取内容再用内置的Pandoc引擎把文档转成Markdown。获取工具很简单把它下载并解压到任意目录即可git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter解压后你会看到OneNoteMdExporter.exe和appSettings.json两个核心文件前者是主程序后者是全部配置项。动手之前先做两件事一是启动OneNote并确认要导出的笔记本已完全加载同步二是如果有些分区设了密码先解锁否则这些分区会直接丢失。跟练四步产出第一个成果第一步双击OneNoteMdExporter.exe按回车跳过欢迎页。预期结果程序列出你账号下所有笔记本前面带序号。常见偏差如果报COMException或提示无法连接OneNote多半是OneNote没完全启动或Office安装有问题稍后翻车现场有详细解法。第二步输入笔记本序号输入0导出全部也可用逗号分隔多个序号回车。预期结果程序询问导出格式输入1标准Markdown或2Joplin专用格式。常见偏差输错格式会提示重新选择不会崩。第三步程序问是否修改设置输入n跳过回车。预期结果程序开始逐页处理屏幕滚动打印页面标题你可以去倒杯水。常见偏差几百页的笔记本要跑几分钟到十几分钟别以为卡死了实在不放心可以打开同目录下的logs.txt看实时日志。第四步等待Export successful提示导出文件夹会自动在资源管理器中打开。预期结果看到Exports/md/你的笔记本名-日期时间目录里面分区变成文件夹页面变成.md文件图片和附件收在resources文件夹里。至此你已拿到第一份成果。我第二次导出时就开始研究怎么让结果更贴合自己的平台下面按三种角色拆解配置策略你按身份取用即可。新手默认配置先让结果能用如果你是个人用户目标是尽快把笔记搬进Obsidian或Typora默认配置其实已经相当好用页面层级按文件夹树展开、图片集中存放在resources根目录、OneNote内部链接自动转成[[页面名]]双链格式、每页开头带YAML元数据头。唯一建议新手动手改一处打开appSettings.json把UseHtmlStyling保持为true。这样字体颜色、背景色、复杂表格会转成HTML标签Obsidian和Typora都支持内嵌HTML能保住这些视觉细节如果你的编辑器不支持HTML再改成false。效率派按平台微调让结果好用用过几次后你会发现同一份笔记在不同编辑器里体验差别很大。效率派值得花十分钟做针对性配置。迁往Obsidian把OneNoteLinksHandling设为ConvertToWikilink默认即是双链可以直接点跳ResourceFolderLocation改成PageParentFolder让每张页面的图片跟随页面文件方便日后单独移动单页而不丢图。迁往JoplinJoplin的导入机制不同建议直接用格式2导出Joplin专用目录并在Joplin里点击文件 导入 RAW - Joplin导出目录完成导入。普通Markdown模式下则建议OneNoteLinksHandling用ConvertToMarkdown、PanDocMarkdownFormat用gfm图片引用交给PostProcessingMdImgRef优化。页面标题有超长情况把PageTitleMaxLength从50调小能避免文件名过长导致路径超限报错。团队与自动化命令行批量导出当你需要处理多个笔记本或者想把它纳入定期备份流程就该上命令行参数了。常用组合如下OneNoteMdExporter.exe --notebook 项目文档 --format 1 --output D:\笔记备份 --no-input这一句表示导出名为项目文档的笔记本输出为Markdown格式到指定目录全程免交互。配合--all-notebooks可以一键导出全部笔记本--ignore-errors让单页失败不中断整个任务。团队场景里把它写进计划任务或脚本就能实现每周自动备份OneNote为开放格式的长期机制比手动导出可靠得多。决策速查表这个场景选这个方案面对配置项时容易纠结记住下面这张表就够了你的目标导出格式关键配置迁入Obsidian/双链笔记Markdown(1)链接用ConvertToWikilink资源放PageParentFolder迁入JoplinJoplin(2)直接导入Joplin原始目录格式通用编辑器/长期归档Markdown(1)链接用ConvertToMarkdown或Remove多笔记本批量备份Markdown(1)命令行加--all-notebooks与--no-input翻车现场我踩过的坑和答案现象双击后直接抛Unhandled exception ... COMException我第一次遇到就懵了后来发现这是环境问题。原因通常是Office组件损坏或OneNote没登录账号、没完成同步。解法按顺序试先完整启动OneNote并登录不行就修复Office安装再不行把笔记本导出为.onepkg包换一台装了Office的电脑导入后再跑一遍导出。官方文档doc/notebook-onepkg-export.md里有完整的打包导出步骤。现象导出完发现图片大量缺失或红叉排查发现多半不是工具的问题而是OneNote本地没缓存完整图片。解法是进OneNote的文件 选项 同步打开下载所有文件和图像强制同步一次再重新导出。这一步对经常在多个设备间切换的用户尤其重要。现象分区顺序乱了页面排序不对工具按文件名排序所以如果笔记靠分区顺序传递信息导出后顺序可能变化。原因和限制在于标准Markdown目录没有原生的排序元数据。解法一是在文件名前加数字前缀如01_、02_二是需要严格保序的场景直接选Joplin格式Joplin目录格式能保留分区和页面顺序。现象标签变成了emoji公式消失了这不是bug是设计取舍OneNote的文本标签任务、星标等会被转换成对应emoji绘图会被扁平化为图片而手写内容和密码分区目前不支持导出。解决方案是在导出前手动把关键手写内容截图进页面重要密码分区先解锁。想确认某项内容支不支持可以查看doc/migration-to-joplin.md里的逐项对比表里面把每个格式的保留情况列得很清楚。融入日常工作流一份可直接套用的备份模板工具真正的价值不在一次性迁移而在于让OneNote转Markdown变成可重复的流程。下面是我现在每周五跑的PowerShell脚本逻辑很简单先列出要备份的笔记本逐个调用导出再核对生成的.md文件数量是否达标$notebooks (工作笔记, 学习资料) foreach ($nb in $notebooks) { OneNoteMdExporter.exe --notebook $nb --format 1 --no-input $md (Get-ChildItem Exports\md -Recurse -Filter *.md | Measure-Object).Count Write-Host $nb 导出完成共 $md 个Markdown文件 }配合Obsidian使用时把导出目录直接放进Obsidian库所在磁盘用Obsidian的文件恢复插件定期检查链接完整性配合Joplin时则把Joplin格式的导出目录设为自动导入文件夹。这套组合让我在本地始终持有一份开放格式的实时备份就算哪天Office订阅到期笔记也永远在自己手里。结尾行动清单现在就做这三步迁移不必一次做完但今天可以先迈出这三小步备份OneNote原始笔记本导出.onepkg或确认云端同步完整用默认配置跑一次小笔记本对照上文四步核对导出结果打开appSettings.json按你的目标平台Obsidian或Joplin改好链接和资源目录两项配置再导出一次正式版本。工具本身是开源的代码和完整文档都在项目仓库里遇到任何疑问都能查证。把五年的笔记从封闭格式里解放出来换成任何人都能读取的Markdown——这份长期价值值得你花一个下午去兑现。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考