zk/docs/note-format.md

Note formats

To keep your notebooks future-proof, zk uses a simple plain text format for your notes. Only Markdown is supported at the moment, but more formats may be added in the future.

Markdown

You can set up some features of zk's Markdown parser from your configuration file, under the [format.markdown] section.

Setting	Default	Description
link-format	"markdown"	Format used to generate internal links (markdown, wiki or custom template)
link-encode-path	-1	Percent-encode paths of generated internal links
link-drop-extension	true	Remove the path file extension of generated internal links
hashtags	true	Enable #hashtags support
colon-tags	false	Enable :colon:separated:tags: support
multiword-tags	false	Enable Bear's #multi-word tags#. Hashtags must also be enabled.

1. Paths are not percent-encoded by default, unless the link-format is markdown.

Customizing the Markdown links generated by zk

By default, zk will generate regular Markdown links for internal links. If you prefer to use [[Wiki Links]] instead, set the link-format setting to wiki. If you want to override completely the link format, you can also set link-format to a custom template. Two variables path and title are available in the template, for example to generate a wiki-link with a title:

[format.markdown]
link-format = "[[{{path}}|{{title}}]]"