Welcome to Jimmy's documentation!

Jimmy logo

Jimmy is a tool to convert your notes from different formats to Markdown.

Installation

Download Jimmy here: Linux | Windows | macOS

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

For a video, check the Github readme.

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 Q QOwnNotes logo QOwnNotes R RedNotebook logo RedNotebook 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 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

flowchart LR
    A[App 1] -->|Backup| M
    B[App 2] -->|Export| M
    C[...] --> M
    D[Filesystem] --> M
    M(ZIP archive/JSON/Folder) --> N
    N{Jimmy} --> O(Markdown + Frontmatter)
    O -->|Import| P[Joplin]
    O -->|Import| Q[Obsidian]
    O --> R[...]
    O --> S[Editor, e. g. VSCode]
  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 even use any editor like VSCode