Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Jimmy logo

Free your notes by converting them to Markdown.

:floppy_disk: Download: Linux | Windows | macOS GitHub Downloads (all assets, all releases)

If there is an issue at download or execution, please take a look at the step-by-step instructions.

:blue_book: Documentation

:star: If Jimmy is useful for you, feel free to star it on GitHub.

build lint tests

Use Cases

  • Migrate between note apps. Jimmy's output is compatible with Joplin, Obsidian and more.
  • Save your notes in a future-proof, human-readable format.
  • Prepare your notes for processing in a LLM.
  • Convert folders of office documents and PDFs recursively to Markdown.

Demo

Jimmy provides two interfaces:

  • The Command Line Interface (CLI) can be used for scripting and provides the full set of features.
  • The Terminal User Interface (TUI) can be used to do the conversion interactively. Currently it provides only a feature subset and is still in beta.

Example commands for Linux:

# do the conversion using an interactive TUI jimmy-linux tui # convert a single file supported by pandoc jimmy-linux cli libre_office_document.odt # convert all files in a folder jimmy-linux cli path/to/folder # convert a Google Keep export jimmy-linux cli takeout-20240401T160516Z-001.zip --format google_keep

This is an example of a successful conversion:

TUICLI

If there is an issue at download or execution, please take a look at the step-by-step instructions.

Features

  • ✅ Several supported input formats
  • ✅ Markdown + Front matter output
    • Compatible with any text editor
    • Can be imported to Joplin/Obsidian/...
    • Preserves resources, tags and note links when possible
  • ✅ Offline
  • ✅ Open Source
  • ✅ Cross-platform
  • ✅ Standalone (no Docker, Python or Node.js installation required)
  • ❎ No AI used during conversion

Supported Apps

Export data from your app and convert it to Markdown. For details, click on the links.

A Anki logo Anki Anytype logo Anytype B Bear logo Bear C Cacher logo Cacher CherryTree logo CherryTree Clipto logo Clipto ColorNote logo ColorNote D Day One logo Day One Diaro logo Diaro Drafts logo Drafts Dynalist logo Dynalist E Evernote logo Evernote F Facebook logo Facebook FuseBase logo FuseBase / Nimbus Note G Google Docs logo Google Docs Google Keep logo Google Keep J Joplin logo Joplin jrnl logo jrnl N Notion logo Notion O Obsidian logo Obsidian OneNote logo OneNote Q QOwnNotes logo QOwnNotes R RedNotebook logo RedNotebook Reflect logo Reflect Roam Research logo Roam Research S Signal logo Signal Simplenote logo Simplenote Standard Notes logo Standard Notes Synology Note Station logo Synology Note Station T Telegram logo Telegram Textbundle / Textpack Tiddlywiki logo Tiddlywiki Tomboy-ng logo Tomboy-ng / Gnote Turtl logo Turtl U UpNote logo UpNote W Wordpress logo Wordpress Z Zettelkasten logo Zettelkasten Zim logo Zim Zoho Notebook logo Zoho Notebook

Supported Formats

Convert a single file or a folder (recursively). Files of these formats will be converted to Markdown. The formats can be mixed. For example, you can convert a folder with two Asciidoc files and one DOCX file. The conversion result will be a folder with three Markdown files and the corresponding attachments.

A Asciidoc logo Asciidoc C CSV logo CSV D DocBook DOCX logo DOCX E EML EPUB logo EPUB F Fountain logo Fountain H HTML logo HTML J Jupyter Notebook logo Jupyter Notebook M Markdown logo Markdown MediaWiki logo MediaWiki MHTML O ODT logo ODT OPML logo OPML P PDF logo PDF R reStructuredText RTF T txt2tags

General Usage

  1. Export/backup notes from your note application
  2. Run jimmy, which converts your notes to Markdown
  3. Import the result to Joplin/Obsidian or use any editor to view the notes

After conversion, the notes should be available in a folder named like YYYY-MM-DD HH:MM:SS - Import. Make sure your data is converted properly :exclamation:

What is converted (in most cases)?

  • Note content
  • Tags / Labels
  • Images / Resources / Attachments
  • External links and internal note links

Simplified Internal Workflow

Similar Projects

关于 About

Convert your notes to Markdown
bearcherrytreegoogle-keepjoplinmarkdownmarkdown-convertermicrosoft-officenotionobsidianonenotepandocsignalsimplenotestandard-notesstandardnotessynologytelegramtextbundletiddlywikizoho

语言 Languages

Python99.2%
Shell0.8%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
331
Total Commits
峰值: 38次/周
Less
More

核心贡献者 Contributors