Content-Type: text/x-zim-wiki
Wiki-Format: zim 0.4
Creation-Date: Unknown

====== Syntax ======

Examples of the wiki syntax as used by zim.

Most of this syntax is inspired by the [[https://www.dokuwiki.org/wiki:syntax|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:

1. item 1
2. item 2
3. item 3
	a. item 3a

Numbered lists can start with an arbitrary number. However internal inconsistencies will be fixed by renumbering automatically. Off 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
[x] 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 as 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.
