zk

YAML frontmatter

Markdown being a simple format, it does not offer any way to attach additional metadata to a note. The community came up with a solution by inserting a YAML header at the top of each note to contain its metadata. This method is widely supported among Zettelkasten softwares, including zk.

---
title: Improve the structure of essays by rewriting
date: 2011-05-16 09:58:57
keywords: [writing, essay, practice]
---

zk supports the following metadata:

Key Description
title Title of the note – takes precedence over the first heading
date Creation date – takes precedence over the file date
tags List of tags attached to this note
keywords Alias for tags
aliases Alternative titles for this note, used by --mention

All metadata are indexed and can be printed in zk list output, using the template variable , e.g.. The keys are normalized to lower case.