Projects

settle understands your Zettelkasten in terms of projects. A project is any
directory that contains at least one note, i.e. at least one Markdown file.

The catch is that only the root of your Zettelkasten directory and only the
direct subdirectories it contains can count as projects. That is to say, if
the root of your Zettelkasten is at ~/docs/zettelkasten, then
~/docs/zettelkasten/myproject can be a project, but
~/docs/zettelkasten/myproject/mysubproject cannot. Likewise, since ~/docs
isn't a subdirectory of your Zettelkasten's root, it can't count as a project.

Note, however, the root of the Zettelkasten can be referenced by two names:
"main", or "" (empty string)

The role of projects

Projects provide only a formal separation between notes, since any note can
reference any other note, regardless of where they are.

It's up to you how you use projects. General Zettelkasten guidelines indicate
using as few hierarchical structures as possible. They are most practical when
you want to separate notes that shouldn't mix together: you may create a
writings project to hold your publishings, or a literature project to hold
notes on what you read or plan to read.
