Tags

A colour says one thing about a mark. Tags let a mark mean several things at once.

Write one in a mark's comment, with a # in front of it:

about #tenancy and #research

The mark now carries both. They are shown as small bubbles on the mark's card in the Marks and Talk lists, and the command line will list them.

A tag is the word in the comment

Nothing is stored beside the document and there is no separate list to get out of step with what the comments say. Delete the word and the tag is gone; change its spelling and it is a different tag. #tenancy and #tenancies are two tags, and nothing but you will notice.

What counts as a tag

A # begins a tag when what comes before it is not part of a word. These are tags:

#research     (#tenancy) - #polyphenols

These are not:

# a heading    C#    https://example.org/page#anchor    #1

A Markdown heading, a language's name, the fragment of a web address and a bare number are things people write in comments, and none of them is a tag.

Being offered the tags you already use

Type # in a note or comment field and the tags already in use are offered. The spelling offered is the one already in use: type #Ten and you are offered #tenancy, because that is how you wrote it before. Taking the offer is what stops a third spelling appearing.

The offers come from two places, in this order:

1. the tags on this document;
2. your own vocabulary, kept with your settings, so the same list follows you between documents and, through Export Settings…, between machines.

A tag nobody has used before is accepted as typed. See Settings ▸ Tags for adopting tags into your vocabulary and giving them colours.

From the command line

caseleaf tags document.pdf                 every tag, and how many marks carry each
caseleaf tags document.pdf --tag research  the marks carrying one

Watch: a short video for this page is still to come.

Marking text · Contents