Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

marph91/jimmy

Open more actions menu

Repository files navigation

Jimmy logo

Free your notes by converting them to Markdown.

💾 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.

📘 Documentation

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

build lint tests

Use Cases

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:

TUI CLI
jimmy_demo_tui_yuv420.mp4
jimmy_010_demo_h264_yuv420.mp4

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

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 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 O ODT logo ODT OPML logo OPML 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 ❗

What is converted (in most cases)?

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

Simplified Internal Workflow

Similar Projects

Morty Proxy This is a proxified and sanitized view of the page, visit original site.