Zim - A Desktop Wiki
Syntax
Examples of the wiki syntax as used by zim.
Most of this syntax is inspired by the DokuWiki syntax, but with some significant modifications. All markup uses at least two characters to reduce the chance of conflicts between the wiki markup normal typographic use of these characters.
Headings
Headings are created by using an appropriate amount of "=" characters:
====== Head 1 ====== ===== head 2 ===== ==== head 3 ==== === head 4 === == head 5 ==
Links
Link to another page like this:
[[foo]] links to a page on the same level or up [[:foo]] links to a page in the top level of the notebook [[+foo]] links to a sub-page [[foo|bar]] links to "foo" but display "bar"
External links like http://nongnu.org are also supported
Lists
Bullet list just use a "*" at the start of the line:
* item 1 * item 2 * item 3 * item 3a
Will be rendered as:
- item 1
- item 2
- item 3
- item 3a
Numbered lists use a "1.", "a.", or "A." as bullets:
- item 1
- item 2
- item 3
- item 3a
Numbered lists can start with an arbitrary number. However internal inconsistencies will be fixed by renumbering automatically. Of course, you can mix numbered lists with bullet sub-lists and vice versa.
Checkbox lists look like this:
[ ] foo [*] bar [*] sub item 1 [*] sub item 2 [x] baz
This renders as:
- foo
- bar
- sub item 1
- sub item 2
- baz
Of course, the checkboxes are clickable in zim. See Check Boxes for more details.
Markup
bold, italic and underline and verbatim
**bold**, //italic// and __underline__ and ''verbatim''
and also strike through
and also ~~strike through~~
Using verbatim also prevents any further parsing of the content. To render a whole block verbatim, the first and last line of the block should contain 3 quotes and no other characters:
Sing, O goddess, the rage of Achilles son of Peleus, that brought countless ills upon the Achaeans.
This can be used for code examples etc.
Before version 0.26 all indented paragraphs were rendered verbatim as well. This has been changed because it conflicted with the typographic use of indenting paragraphs that were not intended as verbatim. However to maintain backwards compatibility this style is still supported for any page that does not have headers indicating that it was written by version 0.26 or newer.
You can combine all standard inline markup, the main exception is "verbatim" formatted text.
Images
To include images use:
{{./foobar.png}}
The filename for an image can either be absolute or relative. If relative it is looked for in the same directory as where the text source of the current page is.