Zim

This page describes how to convert notes from Zim Wiki to Markdown.

General Information

  • Website
  • Typical extension: Folder with .txt files

Instructions

  1. Install jimmy
  2. Convert to Markdown. Example: jimmy-cli-linux zim/folder --format zim
  3. Import to your app

Import Structure

Zim does a good job in exporting to Markdown. If the built-in export is fine for you, you don't need to use Jimmy.

Jimmy doesn't use pandoc for conversion and applies some additional tweaks:

  • Consistently use ATX style headings (starting with #).
  • Consistently use spaces instea of tabs.
  • Page title and creation date are removed from the note body. They are instead stored in the metadata respectively the filename. The metadata can be included by a front matter.
  • Convert Zim checklists to Markdown checklists (- [ ]) instead of Markdown lists with signs (- ☐). The checklist states are converted as described below:
    • Done and not done are converted to - [x].
    • All other states are converted to -[ ].