In Zettelkasten tags are usually redundant.
wb provides a simple
implementation that may serve as an additional grouping layer generating Backlinks.
Documents can be tagged via Front Matter.
Before rendering is triggered,
wb collects all the tagged documents, and writes unified tag index to disk in
tags/ directory under Layout Root. This directory contains a list of all tags and can be referenced via
Default templates do not link the tag index out of the box.
👀 This documentation is tagged for illustrative purposes. You can access the tag index here. This document has been tagged as #interesting.
⚠️ The tags implementation comes with a couple of caveats:
the user must not keep any static, custom content under the
tagsdirectory, otherwise they risk data loss when
wboverwrites that specific subdirectory contents.
the user should not keep any document/directory explicitly titled/named
tagsin their Layout Root, otherwise linking to automatically generated tag index may become impossible via Wikilinks. In other words, if you decide to keep a
tags.mdfile somewhere or a document annotated with
title: tagsfront-matter meta, the
[[tags]]reference will probably resolve to your document and not to the
So the rule of thumb is: if you like to use document tags, do not create your own files/directories named
Assuming we have a sample set of documents tagged as follows:
--- title: Document one tags: - happy --- ...(contents)
--- title: Document two tags: - happy - fun --- ...(contents)
wb will create the following structure in :
tags ├── happy │ └── index.md └── fun └── index.md
happy/index.mdwill contain links to
fun/index.mdwill contain only one link to
doc2.md rendered will be annotated with