如何高效完成OneNote转Markdown？开源工具全攻略

如何高效完成OneNote转Markdown？开源工具全攻略

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

OneNote Markdown 导出工具（onenote-md-exporter）是一款开源控制台应用，专为解决OneNote笔记格式封闭、难以迁移的痛点而生。它能将OneNote笔记本无损转换为标准Markdown格式，特别适合需要迁移到Joplin、Obsidian等知识管理工具的用户，核心优势在于格式兼容性强、操作简单且转换质量优于同类工具。

评估功能价值：为什么选择这款导出工具

许多用户面临OneNote笔记迁移难题：手动复制粘贴格式错乱、第三方工具转换丢失附件、付费软件成本高昂。本工具通过深度解析OneNote内部格式，实现文本、图片、表格的完整转换，同时支持自定义导出规则，让知识管理迁移不再困难。

核心解决的3个关键问题

• 格式保真：保留原笔记的排版结构和媒体资源
• 批量处理：支持整个笔记本的一键导出
• 开放格式：生成标准Markdown文件，兼容主流知识管理软件

快速上手：3步完成首次导出

1. 验证环境兼容性

确保系统满足运行要求：

• Windows 10/11操作系统
• OneNote 2013及以上桌面版（不支持Microsoft Store版本）
• Word 2013及以上（用于格式转换支持）

💡 技巧：按Win+R输入winver检查Windows版本，在OneNote中通过「文件→账户」确认版本信息。

2. 2分钟完成工具部署

从项目仓库获取工具包后：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter

解压到任意目录，无需安装即可使用。工具目录结构清晰，核心执行文件为OneNoteMdExporter.exe。

3. 执行首次导出操作

1. 启动OneNote并确保目标笔记本已打开
2. 双击运行OneNoteMdExporter.exe
3. 在控制台菜单中选择要导出的笔记本
4. 选择"Markdown"格式，按Enter确认
5. 等待进度完成，自动打开导出目录

⚠️ 注意：首次运行会提示获取OneNote访问权限，需点击允许以确保工具正常工作。

深度配置：自定义你的导出规则

理解配置文件结构

工具根目录下的appSettings.json文件控制导出行为，关键配置项包括：

• ResourceFolderLocation：附件保存位置（相对/绝对路径）
• IndentingStyle：Markdown列表缩进样式（空格/制表符）
• OneNoteLinksHandling：内部链接处理方式（保留/转换为相对路径）

5分钟完成高级设置

修改配置文件实现个性化导出：

{ "ExportSettings": { "OutputFormat": "markdown", "ResourceFolderName": "assets", "IndentSize": 2, "IncludePageCreationTime": true } }

• ResourceFolderName：设置附件文件夹名称为"assets"
• IndentSize：将列表缩进设置为2个空格
• IncludePageCreationTime：在Markdown头部添加创建时间元数据

💡 技巧：配置变更后无需重启工具，下次导出自动生效。

扩展应用：解锁命令行与脚本能力

CLI命令行界面详解

通过命令行直接执行导出操作，适合批量处理和自动化场景：

# 基本导出命令 OneNoteMdExporter.exe --notebook "工作笔记" --output "D:\notes\export" # 常用参数说明 --format joplin # 导出为Joplin兼容格式 --overwrite # 覆盖已有文件 --silent # 静默模式运行，无交互界面

实用脚本案例1：定时备份笔记本

创建backup_notes.bat批处理文件：

@echo off set NOTEBOOK="个人知识库" set BACKUP_DIR="D:\OneNoteBackups\%date:~0,4%%date:~5,2%%date:~8,2%" mkdir %BACKUP_DIR% OneNoteMdExporter.exe --notebook %NOTEBOOK% --output %BACKUP_DIR% --format markdown --overwrite

将此脚本添加到Windows任务计划程序，实现每日自动备份。

实用脚本案例2：多笔记本批量导出

创建export_all.bat处理多个笔记本：

@echo off set NOTEBOOKS=("工作笔记" "学习笔记" "项目文档") set OUTPUT_BASE="D:\OneNoteExports" for %%n in %NOTEBOOKS% do ( echo Exporting %%n... OneNoteMdExporter.exe --notebook %%n --output %OUTPUT_BASE%\%%n --format markdown )

适合需要统一管理多个笔记本导出的场景。

常见问题速解

Q1: 导出后图片无法显示？

A: 检查ResourceFolderLocation配置，确保图片文件夹与Markdown文件相对路径正确，通常设置为"./assets"即可。

Q2: OneNote表格导出后格式错乱？

A: 工具默认使用GitHub Flavored Markdown表格格式，如目标平台不支持，可在配置中设置TableFormat: "simple"使用简化表格。

Q3: 提示"无法访问OneNote应用"？

A: 确保OneNote已启动并登录账户，关闭UAC权限提示，以管理员身份重新运行工具。

相关资源

• 完整参数说明：docs/parameters.md
• 配置示例库：src/OneNoteMdExporter/Resources/
• 问题反馈：项目issue系统
• 功能扩展：src/OneNoteMdExporter/Services/Export/

通过本工具，你可以轻松摆脱OneNote的格式束缚，将宝贵的知识资产转换为通用的Markdown格式，为知识管理打开更多可能性。无论是个人笔记备份还是团队知识库迁移，这款开源工具都能提供高效可靠的解决方案。

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