Guides › Tags

Tags that organize themselves

One tag layer, two doors: type #tags straight into the text, or add Keywords in the inspector — both feed a single index that follows you across every view and every device.

Two ways in, one index

Type #methods or #ch3-revision anywhere in a document and it becomes a tag. Prefer to keep the prose clean? Add the same words to the Keywords field in the inspector instead — a chip editor that commits on Space or Return and suggests your existing tags as you type, so spellings converge instead of forking. Either way the tag lands in the same project-wide index, and renders as a colored capsule everywhere: the inspector, the ⌘L Tags tab, and the editor itself. Each tag keeps the same color on every device, with nothing extra stored in your files.

Decide what a typed tag does

Settings ▸ Editor ▸ Inline #tags chooses the behavior: render as a capsule, stay plain text, or Move to Keywords — the tag is stripped from the text and filed in the inspector the moment you finish typing it. That last mode gives you the speed of inline tagging with the cleanliness of keywords.

The Tag Index

Compile ▸ Tag Index… (it lives beside the Name Index) lists every tag with per-document mention counts — click a document to jump straight to the tag there. From a tag's context menu you can rename it project-wide: Keywords, inline occurrences, and every case variant, all at once.

Search that understands tags

Project search accepts tag: and #… filters, and # autocompletes in the editor. Folio is careful about what a tag is not: cross-reference anchors (#fig:, #tbl:, #eq:) are never mistaken for tags, and Typst code, YAML metadata, and .bib files are exempt entirely.