---
title: "Tags"
description: "Tags hierárquicas como um eixo de navegação: um filtro por facetas no Feed e no Grafo."
---

# Tags

As tags no Notarium são um eixo de navegação completo, não apenas rótulos nos cartões. Você as define no frontmatter de uma nota, e o Notarium as transforma em um **filtro por facetas**: um clique reduz o Feed ou o Grafo ao tema que você quer. As tags são **hierárquicas** (via `/`) e **não diferenciam maiúsculas de minúsculas**.

## Como definir tags

As tags ficam no frontmatter de uma nota — o bloco YAML comum no início do arquivo:

```md
---
title: Anotações sobre transformers
tags: [ml/nlp, leitura]
---

Corpo da nota…
```

A hierarquia é expressa com `/`: `ml/nlp` é a tag `nlp` dentro de `ml`. Maiúsculas e minúsculas não importam — `ML` e `ml` contam como uma única tag.

## Hierarquia e filtragem

A propriedade-chave da hierarquia é que **um pai inclui seus filhos**. Filtrar por `ml` mostra tanto as notas com `ml` quanto as com `ml/nlp` e `ml/cv`. Isso permite manter as tags tão granulares quanto for conveniente, sem perder a capacidade de ver um tema por inteiro.

O filtro funciona como uma **união (OR)**: selecione várias tags e a seleção se amplia — aparecem as notas que correspondem a qualquer uma delas. Não selecione nada e não há filtro.

O widget de filtro fala a mesma língua em dois lugares:

- **No [Feed](/docs/guides/feed/)** — um painel de tags ao lado das pastas e da busca por texto. As tags fazem parte da URL, então uma visão filtrada pode ser salva como marcador ou compartilhada. A janela do Feed, o contador e o histograma por datas descrevem exatamente a seleção filtrada.
- **No [Grafo](/docs/concepts/knowledge-graph/)** — os mesmos chips hierárquicos, mais um seletor Todas / Com tags / Sem tags.

Os chips de tag no **cabeçalho do leitor** e no **painel de metadados** são links: clicar em um abre o Feed filtrado por aquela tag. Nos **cartões do Feed**, o chip de tag faz parte do próprio cartão: clicar nele (inclusive no chip) abre a nota, e não o Feed filtrado pela tag.

> [!tip] Tags e pastas são eixos diferentes
> Uma pasta responde a "onde a nota está"; uma tag responde a "sobre o que ela é". Elas se combinam: `pasta ∧ tag ∧ texto` — uma única língua de filtragem no Feed. A mesma nota pode ser encontrada tanto pela árvore de pastas quanto por qualquer uma de suas tags.