Welcome to jimmy's documentation!¶
jimmy is a tool to import your notes from different formats to Markdown.
Features¶
- ✅ Several supported input formats
- ✅ Markdown + Frontmatter 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 NodeJS installation required)
Installation¶
Download jimmy here: Linux | Windows | MacOS
Supported Apps¶
Export data from your app and convert it to Markdown. For details, click on the links.
Supported Formats¶
Import 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 import 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
For detailed instructions, see the page of the specific format.
Quickstart¶
- Import from text files or import from specific apps, like Google Keep
- Verify that everything was converted properly. The Markdown notes should be available in a new folder named like
YYYY-MM-DD HH:MM:SS - Jimmy Import
.