zettel-lint

---

title: Readme references: [00000001] notes: YAML top matter is supported

---

If you are a coder and watch to submit a PR, please see the Contributor guide Contributor Covenant Code of Conduct.

If you are not a confident coder and would like to contribute please look at the task list. I will accept PRs that add issues from that file and update the md to point to them, so long as you at least do all the tasks in a section.

ZL

A linter/compiler for markdown-based Zettelkasten git repositories

Based on the Zettelkasten method

This is a link to a Page that doesn't exist

[This is a link to a page that doesn't exist - an orphan]

[00000000] points back here

[ ] This is a task

[x] This completed task is ignored

• [ ] Also supports tasks in a bullet list
• [x] if they aren't completed

Tags can use #hashtag or +projectref formats for compatibility with todo.txt files

To refresh index:

• cd zle
• npm i
• npm run-script zl -- -r ../ -i "../zle/**" -r ../references.md

This will use the references.md.mustache as the template for the references file.

See example journal for the style of repo this could be used on.

Templating

Some features accept a mustache based template to generate their output.

For the indexer, there is a {{#notes}} collection with all notes, as well as a collection named after each collector.

Each collector looks for specific features. For example, the TagCollector looks for #hashtag and +project references, the TaskCollector looks for [ ] Tasks or (A) todo.txt style

Each note has the following properties:

• id - the unique internal id (usually the timestamp from the filename)
• filename
• wikiname - filename without the last 3 characters, which turns a .md file into its wiki reference.
• title - taken from YAML top matter, the first # H1 header or the filename, in that order
• data - the collection of matches by this collector in this file

Template extensions

• {{``markdownEscaping}} Using the backtick at the start of the tag will escape any markdown characters into an HTML escaped version.
• {{?tag[filter]}}{{/?tag}} Using a ? at the start of a tag pair will filter any output using the specified regular expression.