Jimmy 是一个笔记转换工具,目标是把不同笔记应用或文档格式里的内容转换成 Markdown。它适合想把笔记从封闭应用里迁出来、放进 Obsidian、Joplin,或者只想长期保存为纯文本的人。
项目文档里的定位很直接:导出或备份原笔记应用的数据,运行 jimmy 转换,再把结果导入 Joplin、Obsidian,或者直接用 VSCode 等文本编辑器查看。
Jimmy 解决什么问题
很多笔记应用都有自己的导出格式。换应用时,最麻烦的往往不是文字内容,而是图片、附件、标签、内部链接和 front matter 这些结构化信息。
Jimmy 做的事情就是把这些导出数据尽量整理成更通用的 Markdown 目录:
- 笔记正文转换为 Markdown。
- 尽量保留图片、资源和附件。
- 尽量保留标签、外部链接和笔记内部链接。
- 输出 Markdown + front matter。
- 结果可以导入 Joplin、Obsidian 等工具,也可以直接用文本编辑器查看。
这类工具的意义在于降低迁移成本。笔记一旦变成 Markdown,就不再强绑定某个应用,后续备份、搜索、版本管理和 LLM 处理都会简单很多。
支持的笔记应用很多
Jimmy 支持的来源覆盖面很广,包括 Anki、Anytype、Bear、CherryTree、ColorNote、Day One、Diaro、Drafts、Dynalist、Evernote、Google Docs、Google Keep、Joplin、Notion、Obsidian、OneNote、QOwnNotes、RedNotebook、Reflect、Roam Research、Signal、Simplenote、Standard Notes、Synology Note Station、Telegram、Tiddlywiki、Turtl、UpNote、Wordpress、Zim、Zoho Notebook 等。
并不是所有来源的保真度都完全一样。实际迁移时,仍然要先用一小批笔记试跑,重点检查图片、附件、标签、内部链接和日期字段是否符合预期。
也能转换普通文档
除了笔记应用导出,Jimmy 也能处理一些常见文档格式。文档中提到可以转换单个文件,也可以递归转换整个文件夹,适合把杂乱的资料目录整理成 Markdown。
常见支持格式包括:
| 类型 | 例子 |
|---|---|
| 办公文档 | DOCX、ODT、RTF |
| 标记语言 | Asciidoc、DocBook、Markdown、MediaWiki、reStructuredText |
| 网页与电子书 | HTML、MHTML、EPUB |
| 数据与结构化文件 | CSV、OPML、Jupyter Notebook |
| 其他 | PDF、EML、Fountain、txt2tags |
如果只是把 DOCX、PDF 或 HTML 批量转成 Markdown,Jimmy 也可以作为一个离线批处理工具来用。
两种使用方式
Jimmy 提供 CLI 和 TUI 两种界面。
| 界面 | 适合场景 | 说明 |
|---|---|---|
| CLI | 批处理、脚本、完整功能 | 适合一次性转换文件夹、写迁移脚本、指定来源格式 |
| TUI | 交互式转换 | 适合手动操作,目前功能子集仍处于 beta 状态 |
官方 README 给出的 Linux 示例命令如下:
|
|
这些命令说明它不是只面向某一个笔记应用,而是把“笔记导出包”和“普通文档目录”都纳入了同一套转换流程。
它的几个特点
| 特点 | 说明 |
|---|---|
| 离线运行 | 转换过程不依赖云服务,适合处理私人笔记 |
| 开源 | 仓库采用 GPL-3.0 license |
| 跨平台 | 官方提供 Linux、Windows、macOS 下载 |
| 独立二进制 | 不要求用户额外安装 Docker、Python 或 Node.js |
| 不使用 AI | 转换过程不调用 AI,结果更可控,也减少隐私顾虑 |
| Markdown + front matter | 方便导入笔记软件,也方便后续用 Git 管理 |
其中“离线”和“不使用 AI”很适合笔记迁移场景。笔记里经常有私人信息、工作资料和历史附件,把转换放在本地完成,会让风险边界更清楚。
适合谁使用
Jimmy 适合几类人:
- 想从 Evernote、Notion、OneNote、Google Keep 等工具迁移到 Markdown 的用户。
- 想把笔记导入 Obsidian、Joplin 或其他纯文本工作流的人。
- 想把长期资料保存为未来更容易读取格式的人。
- 想把笔记或文档准备成 LLM 可处理文本的人。
- 需要递归转换 DOCX、PDF、HTML、ODT 等文件夹资料的人。
它不一定适合追求“一键完美迁移”的用户。不同笔记应用导出格式差异很大,复杂页面、数据库、嵌入内容和内部链接都可能需要人工复查。
使用前的检查建议
真正迁移前,建议按这个顺序做:
- 先从原笔记应用导出一小批样本。
- 用 Jimmy 转换样本,而不是一上来转换全部笔记。
- 检查 Markdown 正文、图片、附件、标签、创建时间、内部链接。
- 确认目标应用,例如 Obsidian 或 Joplin,能正确识别目录结构和 front matter。
- 再对完整导出包执行转换。
- 保留原始导出包和转换结果,至少等确认无误后再清理。
这个流程虽然慢一点,但能避免迁移后才发现附件丢失、链接断掉或标签结构不对。
我的判断
Jimmy 的价值在于把笔记迁移从“依赖某个应用的导入器”变成“先转成通用 Markdown”。它支持的来源很多,输出也足够通用,适合把个人知识库从封闭格式里释放出来。
如果你只是偶尔导出一两篇笔记,可能用不到它。但如果你有多年积累的笔记、附件和文档目录,想迁移到 Obsidian、Joplin 或 Git 管理的 Markdown 工作流,Jimmy 很值得试。它最适合做迁移中间层:先把数据变成可读、可备份、可批处理的文本,再决定放进哪个笔记系统。
项目链接:marph91/jimmy
文档链接:Jimmy - Note Conversion Tool