Nó🔗

Definição. Unidade elementar de um mapa: um texto com posição na hierarquia, mais um conjunto de propriedades e conteúdos associados.

O verbete nó aparece também no glossário consolidado do guia.

O que um nó carrega🔗

Componente	Descrição
Texto	O rótulo visível; deve ser curto
ID	Identificador estável, usado por links e fórmulas
Ícones	Zero ou mais marcadores à esquerda do texto
Atributos	Pares chave-valor exibidos numa tabela
Nota	Texto rico oculto, com ícone indicativo
Detalhe	Texto rico dobrável, visível no mapa
Link	Hiperlink externo ou para outro nó
Estilo	Nome do estilo aplicado
Formatação direta	Cor, fonte, forma aplicadas ao nó específico
Datas	Criação e última modificação
Estado de dobramento	Aberto ou fechado
Filhos	Zero ou mais nós subordinados

Um nó tem exatamente um pai — exceto a raiz, que não tem nenhum. Essa restrição é o que faz do mapa uma árvore.

No arquivo🔗

<node TEXT="Contratar desenvolvedora"
      ID="ID_1673829104"
      CREATED="1690000000000"
      MODIFIED="1690003600000"
      POSITION="right"
      FOLDED="false"
      STYLE_REF="Bloqueado">
  <icon BUILTIN="button_cancel"/>
  <attribute NAME="responsável" VALUE="Ana"/>
  <attribute NAME="prazo" VALUE="2026-09-15"/>
  <richcontent TYPE="NOTE"><html><body><p>Aprovado em 12/07.</p></body></html></richcontent>
  <node TEXT="Publicar vaga" ID="ID_1673829105"/>
</node>

CREATED e MODIFIED são timestamps Unix em milissegundos. POSITION só aparece nos filhos diretos da raiz, indicando de que lado do mapa o ramo fica.

Tipos especiais🔗

Nó raiz — o centro, um por mapa.
Nó resumo — refere-se a um intervalo de irmãos, com uma chave ao lado.
Nó flutuante — solto sobre o mapa, sem aresta ligando ao pai.
Nó criptografado — ramo protegido por senha.
Nó com fórmula — texto começando com =, avaliado como Groovy.
Nó LaTeX — conteúdo renderizado como matemática.

Quanto texto cabe🔗

Tecnicamente, qualquer quantidade. Na prática, três a cinco palavras. Um mapa cujos nós têm frases inteiras perde a vantagem visual e vira um documento mal formatado.

O conteúdo longo tem lugar próprio: nota ou detalhe.

Identidade e estabilidade🔗

O ID é gerado na criação e não muda quando o nó é editado, movido ou reordenado. Isso é o que permite:

links internos que sobrevivem a reorganizações;
fórmulas que referenciam outros nós de forma confiável;
diffs de Git que reconhecem o mesmo nó entre versões.

Copiar e colar um nó gera um ID novo — a cópia é outro nó. Recortar e colar preserva o ID.

Erros comuns

Escrever no rótulo o que deveria estar em nota ou detalhe, alargando o nó
Copiar e colar um nó esperando manter o ID — a cópia recebe um ID novo, e links para ela quebram
Contar com MODIFIED como registro de auditoria: qualquer edição, inclusive dobrar, pode atualizá-lo
Aplicar formatação direta e depois estranhar que o estilo não pega

Perguntas para reflexão

Que informação você poria em atributo, e qual poria em detalhe? Justifique pelo custo de acesso.
Por que o ID precisa ser estável, e o que depende dessa estabilidade?
O que distingue recortar-e-colar de copiar-e-colar, do ponto de vista do arquivo?
Um nó tem exatamente um pai. Qual consequência estrutural isso tem para o mapa inteiro?

Nó

Nó🔗