Welcome to Jimmy's documentation!¶

Jimmy logo

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

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

Use Cases¶

Migrate between note apps
Save your notes in a future-proof, human-readable format
Prepare your notes for processing in a LLM

Installation¶

Download Jimmy here: Linux | Windows | macOS

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

Supported Apps¶

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


A	Anki	Anytype
B	Bear
C	Cacher	CherryTree	Clipto	ColorNote
D	Day One	Drafts	Dynalist
E	Evernote
F	Facebook	FuseBase, Nimbus Note
G	Google Docs	Google Keep
J	Joplin	jrnl
N	Notion
O	Obsidian
Q	QOwnNotes
R	RedNotebook	Roam Research
S	Simplenote	Standard Notes	Synology Note Station
T	Telegram	Textbundle, Textpack	Tiddlywiki	Tomboy-ng, Gnote	Turtl
W	Wordpress
Z	Zettelkasten	Zim	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
C	CSV
D	DocBook	DOCX
E	EML	EPUB
F	Fountain
H	HTML
J	Jupyter Notebook
M	Markdown	MediaWiki
O	ODT	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]

Export/backup notes from your note application
Run jimmy, which converts your notes to Markdown
Import the result to Joplin/Obsidian or even use any editor like VSCode

Step-by-step Instructions¶

Step	Linux / macOS Example	Windows Example
Export your notes to your download folder	`/home/user/Downloads/Export.zip`	`C:\Users\user\Downloads\Export.zip`
Download Jimmy to your download folder [1]	`/home/user/Downloads/jimmy-cli-linux`	`C:\Users\user\Downloads\jimmy-cli-windows.exe`
Open a terminal	Linux / macOS instructions	Windows instructions
Change to the download folder	`cd /home/user/Downloads/`	`cd C:\Users\user\Downloads\`
Make Jimmy executable	`chmod +x jimmy-cli-linux`	-
Do the conversion [2] [3]	`./jimmy-cli-linux Export.zip --format notion`	`jimmy-cli-windows.exe Export.zip --format notion`
Check the output folder	`/home/user/Downloads/20250226T200101Z - Jimmy Import from notion`	`C:\Users\user\Downloads\20250226T200101Z - Jimmy Import from notion`

[1] On Windows: If Jimmy is flagged as virus, please report the false positive to your antivirus vendor. As workaround, you can try an older version of Jimmy.

[2] On macOS: If there is the error message zsh: bad CPU type in executable, please use this executable. It is supported by Intel chips.

[3] On macOS: If there is the error message "jimmy-cli-darwin-arm64" cannot be opened because the developer cannot be verified, please authorize Jimmy at System Settings → Privacy & Security → Security → Open Anyway. See also the Apple support guide.