Caliu has no folders. Instead, you organize notes with tags: type # followed by a word anywhere in a note, and that note is tagged.
Meeting notes from Tuesday #work
Tags are pulled from your text automatically as you write. Every tag you use appears in the sidebar, and clicking one filters your list to the notes that carry it. One note can hold as many tags as you like.
How tags behave
- Tags are case-insensitive:
#Workand#workare the same tag. - A tag can appear anywhere: in a heading, mid-sentence, or on its own line at the end of the note.
- Deleting the hashtag from the text removes the tag from that note. The note is the source of truth.
- When no notes carry a tag anymore, it disappears from the sidebar on its own. There is nothing to clean up.
Tags with more than one word
A tag ends at the first space, so #my project tags the note with my and leaves "project" as plain text. To keep the words together, close the tag with a second #:
Kickoff notes #my project#
That creates one tag called my project. Spaces work inside nested tags too, as in #work/my project#. The closing hash is optional for a single word: #work# and #work are the same tag.
What does not count as a tag
Hashtags inside code are ignored, so writing #include in a fenced code block or #!/bin/bash in inline code will not create tags. The same goes for the # inside a link destination, like an anchor in a URL.
Want structure? Tags can nest: see the article on nested tags.