https://github.com/marph91/jimmy
Convert your notes to Markdown
https://github.com/marph91/jimmy
anki bear google-keep joplin markdown markdown-converter microsoft-office notion nsx obsidian pandoc simplenote standard-notes standardnotes synology textbundle tiddlywiki todotxt wordpress zoho
Last synced: 26 days ago
JSON representation
Convert your notes to Markdown
- Host: GitHub
- URL: https://github.com/marph91/jimmy
- Owner: marph91
- License: gpl-3.0
- Created: 2024-04-01T11:31:59.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-04-03T17:58:06.000Z (10 months ago)
- Last Synced: 2025-04-03T18:38:03.448Z (10 months ago)
- Topics: anki, bear, google-keep, joplin, markdown, markdown-converter, microsoft-office, notion, nsx, obsidian, pandoc, simplenote, standard-notes, standardnotes, synology, textbundle, tiddlywiki, todotxt, wordpress, zoho
- Language: Python
- Homepage: https://marph91.github.io/jimmy/
- Size: 1.56 MB
- Stars: 74
- Watchers: 2
- Forks: 5
- Open Issues: 8
-
Metadata Files:
- Readme: readme.md
- Contributing: docs/contributing/contributing.md
- License: license
Awesome Lists containing this project
- awesome-markdown - Jimmy :octocat: - Convert your notes to Markdown (Convert to Markdown Tools / Various Note Formats to Markdown)
- awesome-joplin - Jimmy - a-joplin-import-tool/38503)], [[documentation](https://marph91.github.io/jimmy/)]. Import your notes from various formats to Joplin. (Tools)
- awesome-python - Jimmy - Convert your notes to Markdown. (Specific Formats Processing)
- fucking-awesome-python - Jimmy - Convert your notes to Markdown. (Specific Formats Processing)
README
Free your notes by converting them to Markdown.
:floppy_disk: Download: [**Linux**](https://github.com/marph91/jimmy/releases/latest/download/jimmy-linux) | [**Windows**](https://github.com/marph91/jimmy/releases/latest/download/jimmy-windows.exe) | [**macOS**](https://github.com/marph91/jimmy/releases/latest/download/jimmy-darwin-arm64) [](https://hanadigital.github.io/grev/?user=marph91&repo=jimmy)
If there is an issue at download or execution, please take a look at the [step-by-step instructions](https://marph91.github.io/jimmy/using_jimmy/).
:blue_book: [Documentation](https://marph91.github.io/jimmy/)
:star: If Jimmy is useful for you, feel free to star it on [GitHub](https://github.com/marph91/jimmy).
[](https://github.com/marph91/jimmy/actions/workflows/build.yml)
[](https://github.com/marph91/jimmy/actions/workflows/lint.yml)
[](https://github.com/marph91/jimmy/actions/workflows/tests.yml)
## Use Cases
- Migrate between note apps. Jimmy's output is [compatible with Joplin, Obsidian and more](https://marph91.github.io/jimmy/import_instructions/).
- Save your notes in a future-proof, human-readable format.
- Prepare your notes for processing in a LLM.
## 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:
```bash
# 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 |
| --- | --- |
| | |
If there is an issue at download or execution, please take a look at the [step-by-step instructions](https://marph91.github.io/jimmy/using_jimmy/).
## 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](https://marph91.github.io/jimmy/formats/anki/) 
[Anytype](https://marph91.github.io/jimmy/formats/anytype/)
`B` 
[Bear](https://marph91.github.io/jimmy/formats/bear/)
`C` 
[Cacher](https://marph91.github.io/jimmy/formats/cacher/) 
[CherryTree](https://marph91.github.io/jimmy/formats/cherrytree/) 
[Clipto](https://marph91.github.io/jimmy/formats/clipto/) 
[ColorNote](https://marph91.github.io/jimmy/formats/colornote/)
`D` 
[Day One](https://marph91.github.io/jimmy/formats/day_one/) 
[Diaro](https://marph91.github.io/jimmy/formats/diaro/) 
[Drafts](https://marph91.github.io/jimmy/formats/drafts/) 
[Dynalist](https://marph91.github.io/jimmy/formats/dynalist/)
`E` 
[Evernote](https://marph91.github.io/jimmy/formats/evernote/)
`F` 
[Facebook](https://marph91.github.io/jimmy/formats/facebook/) 
[FuseBase / Nimbus Note](https://marph91.github.io/jimmy/formats/nimbus_note/)
`G` 
[Google Docs](https://marph91.github.io/jimmy/formats/google_docs/) 
[Google Keep](https://marph91.github.io/jimmy/formats/google_keep/)
`J` 
[Joplin](https://marph91.github.io/jimmy/formats/joplin/) 
[jrnl](https://marph91.github.io/jimmy/formats/jrnl/)
`N` 
[Notion](https://marph91.github.io/jimmy/formats/notion/)
`O` 
[Obsidian](https://marph91.github.io/jimmy/formats/obsidian/) 
[OneNote](https://marph91.github.io/jimmy/formats/onenote/)
`Q` 
[QOwnNotes](https://marph91.github.io/jimmy/formats/qownnotes/)
`R` 
[RedNotebook](https://marph91.github.io/jimmy/formats/rednotebook/) 
[Reflect](https://marph91.github.io/jimmy/formats/reflect/) 
[Roam Research](https://marph91.github.io/jimmy/formats/roam_research/)
`S` 
[Simplenote](https://marph91.github.io/jimmy/formats/simplenote/) 
[Standard Notes](https://marph91.github.io/jimmy/formats/standard_notes/) 
[Synology Note Station](https://marph91.github.io/jimmy/formats/synology_note_station/)
`T` 
[Telegram](https://marph91.github.io/jimmy/formats/tiddlywiki/) [Textbundle / Textpack](https://marph91.github.io/jimmy/formats/textbundle/) 
[Tiddlywiki](https://marph91.github.io/jimmy/formats/tiddlywiki/) 
[Tomboy-ng / Gnote](https://marph91.github.io/jimmy/formats/tomboy_ng/) 
[Turtl](https://marph91.github.io/jimmy/formats/turtl/)
`U` 
[UpNote](https://marph91.github.io/jimmy/formats/upnote/)
`W` 
[Wordpress](https://marph91.github.io/jimmy/formats/wordpress/)
`Z` 
[Zettelkasten](https://marph91.github.io/jimmy/formats/zettelkasten/) 
[Zim](https://marph91.github.io/jimmy/formats/zim/) 
[Zoho Notebook](https://marph91.github.io/jimmy/formats/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](https://marph91.github.io/jimmy/formats/default/)
`C` 
[CSV](https://marph91.github.io/jimmy/formats/default/)
`D` [DocBook](https://marph91.github.io/jimmy/formats/default/) 
[DOCX](https://marph91.github.io/jimmy/formats/default/)
`E` [EML](https://en.wikipedia.org/wiki/Email#Filename_extensions) 
[EPUB](https://marph91.github.io/jimmy/formats/default/)
`F` 
[Fountain](https://marph91.github.io/jimmy/formats/default/)
`H` 
[HTML](https://marph91.github.io/jimmy/formats/default/)
`J` 
[Jupyter Notebook](https://marph91.github.io/jimmy/formats/default/)
`M` 
[Markdown](https://marph91.github.io/jimmy/formats/default/) 
[MediaWiki](https://marph91.github.io/jimmy/formats/default/)
`O` 
[ODT](https://marph91.github.io/jimmy/formats/default/) 
[OPML](https://marph91.github.io/jimmy/formats/default/)
`R` [reStructuredText](https://marph91.github.io/jimmy/formats/default/) [RTF](https://marph91.github.io/jimmy/formats/default/)
`T` [txt2tags](https://marph91.github.io/jimmy/formats/default/)
## 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 :exclamation:
What is converted (in most cases)?
- Note content
- Tags / Labels
- Images / Resources / Attachments
- External links and internal note links
## Simplified Internal Workflow
## Similar Projects
- [Notesnook Importer](https://github.com/streetwriters/notesnook-importer)
- [Obsidian-Importer](https://github.com/obsidianmd/obsidian-importer)
- [YANOM-Note-O-Matic (fork)](https://github.com/stereohorse/YANOM-Note-O-Matic)
- [MarkItDown](https://github.com/microsoft/markitdown)