想把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导出Markdown这件事官方基本没有现成通道复制粘贴丢格式导出Word再转换更是灾难几千个内部链接全部变成死链。onenote-md-exporter 就是为这个场景诞生的免费开源工具在 Windows 本地运行把整个 OneNote 笔记本整体转换为 Markdown交给 Obsidian、Joplin 等平台直接使用全程数据不离机。换笔记软件前先看懂三条迁移路线的真实差距这一节解决凭什么选它的问题。把市面上三条路线摊开对比你会发现差距比想象中大得多。对比维度onenote-md-exporter官方导出Word手动整理在线转换网站分区/页面层级✅ 文件夹结构完整保留 基本手动重建 大多被压平OneNote内部链接✅ 转为wiki链接或md链接 全部失效 失效图片与附件✅ 按原位置引用并落盘 需逐个手工插入 依赖网络下载数据安全✅ 全程本地处理✅ 本地 笔记上传云端成本免费开源免费但极费时通常要订阅小结一句话如果你想同时保住层级、链接、附件又不想把私人笔记传上网本地方案基本是唯一答案而这个工具正是其中做得最完整的一个。一次真实搬家阿文把五年笔记整体移入Obsidian这一节用一次完整操作回答这工具到底怎么用。阿文是后端工程师五年攒了1200篇技术笔记他的目标是整体迁入 Obsidian。整个过程只有五步跟着走一遍就会了。第一步先让OneNote醒着。启动 OneNote确认要导出的笔记本已加载并完成同步。工具需要借助 OneNote 自身的 COM 接口读取数据笔记本没加载就什么都读不到。第二步运行程序输入笔记本编号。双击OneNoteMdExporter.exe它会列出检测到的所有笔记本输入对应编号回车即可。想省事也可以直接命令行指定OneNoteMdExporter.exe --notebook 技术笔记 --format 1第三步选择导出格式。界面会让你选1Markdown 文件夹适合 Obsidian/Logseq或2Joplin 原始目录格式专供 Joplin 导入。阿文选了 1。第四步按需改配置。程序会问是否调整设置输入 y 就会用记事本打开appSettings.json。阿文把链接处理改成 Wiki 格式Obsidian 需要其余保持默认。改完保存关闭回车继续。第五步等结果。导出过程中程序会通过 OneNote 把每页转成 DocX再用内置的 Pandoc 引擎翻译成 Markdown最后跑一遍正则后处理修复格式。完成后面输出文件夹会自动在资源管理器中打开。阿文喝了两杯咖啡1200 页全部导出完毕Obsidian 里直接建立 Vault 指向该目录就能用。小结交互式界面适合第一次用摸熟之后你会发现命令行才是批量操作的真正主力。真正决定导出质量的四个配置参数通俗版这一节讲清楚默认值能用但调对参数能让结果质变。appSettings.json有二十多个键但九成用户只需要关心这四个。ProcessingOfPageHierarchy页面层级怎么摆。默认HierarchyAsFolderTree让父页面变成子页面的文件夹如技术笔记/网络/子页面.md改成HierarchyAsPageTitlePrefix则变成文件名前缀父页面_子页面.mdIgnoreHierarchy直接忽略层级适合只想要纯文本的人。OneNoteLinksHandling老链接的去向。四个选项对应四种命运KeepOriginal保留onenote://原格式、ConvertToMarkdown转标准链接、ConvertToWikilink转[[页面|文字]]双链Obsidian 首选也是默认值、Remove只留文字删掉链接。ResourceFolderLocation图片附件放哪。RootFolder统一堆在导出目录的resources文件夹里默认PageParentFolder把资源放在各页 md 文件旁边方便单独挪动某篇笔记时图片跟着走。AddFrontMatterHeader要不要元数据头。设为true会在每页开头生成 YAML 头写入标题、创建时间和最后修改时间对 Obsidian 的属性面板和 Dataview 插件尤其有用。小结四个参数对应层级、链接、资源、元数据四件事想清楚自己的目的地是哪个软件再决定怎么配。新手最容易踩的四个坑附快问快答这一节帮你提前排雷避免导出完才发现白忙一场。坑一装了 Windows 商店版 OneNote。工具要求 OneNote 2013 及以上桌面版商店版不支持。检查方式很简单桌面版标题栏会显示OneNote for Windows 10以外的完整版本号。坑二导出后图片大量丢失。90% 的情况是 OneNote 本地没缓存图片。去文件 → 选项 → 同步勾选下载所有文件和图像强制同步后再跑一次基本能解决。坑三启动报COMException。这是你电脑上 OneNote/Word 组件出问题跟工具本身无关。先试重新安装 Office还不行就在另一台电脑上把笔记本导出为.onepkg包文件 → 导出 → OneNote 包导入后换机器跑。项目文档doc/notebook-onepkg-export.md有完整说明。坑四以为什么都保得住。工具能保住文本、图片、附件、表格、标签但手写内容会丢失密码保护分区必须先解锁绘图会被压平成图片。导出前建议先拿小笔记本试跑一遍。小结这四个坑的共性教训是——先小规模试导出验证再大规模正式迁移。怎么确认这次搬家没翻车两个验证方法加两个进阶技巧这一节给结果怎么验收和怎么把工具用得更顺手。先看官方支持矩阵做核对。文本、图片、附件、简单表格转 Markdown 表格、复杂表格保留为 HTML 表格、折叠段落、字体与背景色HTML 形式、文本标签转表情符号都支持绘图压平为图片。验收时建议按三件事抽查结构文件夹层级是否和原笔记本一致、数量页面总数是否对得上、质量随机抽 10% 页面检查表格、图片、链接。两个进阶技巧值得收藏只导出指定分区或页面。加--section 分区名或--page 页面名配合--notebook使用适合先拿最复杂的几页试水。无人值守批量导出。--all-notebooks一次导出所有笔记本--no-input跳过一切交互提示两个参数合起来就能塞进计划任务里定时跑全程不需要人守着。小结验证要量化对页数、抽比例批量要自动化这才是把工具价值榨干的方式。这个开源项目能陪你走多远这一节回答用完之后遇到问题、想参与怎么办。项目当前版本 1.6.0基于 .NET 10 构建GPL-3.0 协议开源。程序自带多语言界面英文、法文、西班牙文、中文系统是中文就自动显示中文菜单。运行目录下的logs.txt记录每一步日志遇到问题用--debug跑一遍把日志带上反馈作者和社区才能精准定位。想深入源码入口很清晰src/OneNoteMdExporter/Services/Export/下是两种格式的导出服务doc/contribute.md写了贡献规范和提交流程翻译文件在Resources/目录想给中文翻译纠错或新增语言都能直接上手。你的下一步行动清单今天打开 OneNote 同步笔记本从 Releases 下载最新版解压后确认目录里有pandoc.exe发行包自带无需手动安装。明天拿最复杂的一两个分区试导出核对层级、图片、链接三项是否达标。本周根据目标平台调好四个关键参数用--all-notebooks完成全部笔记本的正式导出。长期保留 OneNote 原件做备份把导出目录纳入你的新笔记工作流。如果你也正在搬家的路上或者已经用这个工具完成过迁移欢迎在评论区聊聊你最舍不得丢的 OneNote 功能是什么踩过哪些我上面没提到的坑你的经验可能正是下一位读者最需要的那块拼图。【免费下载链接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats项目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考