Welcome to Jimmy's documentation!¶
Jimmy is a tool to convert your notes from different formats to Markdown.
Installation¶
Download Jimmy here: Linux | Windows | macOS
Use Cases¶
- Migrate between note apps
- Save your notes in a future-proof, human-readable format
- Prepare your notes for processing in a LLM
Demo¶
Example commands for the Linux CLI app:
# convert a single file supported by pandoc
jimmy-cli-linux libre_office_document.odt
# convert all files in a folder
jimmy-cli-linux path/to/folder
# convert a Google Keep export
jimmy-cli-linux takeout-20240401T160516Z-001.zip --format google_keep
For a video, check the Github readme.
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
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.