Markdown IDs de cabeçalho
Última atualização: 2026-10-14
IDs de cabeçalho Extensões comuns
Sintaxe estendida. Acrescente {#custom-id} ao título para criar uma âncora personalizada e use [texto](#custom-id) para saltar dentro da página. É a infraestrutura para sumários de documentos longos, links de retorno em FAQ e referências cruzadas.
| Grupo | Extensões GFM |
|---|---|
| Nível de especificação | Extensões comuns |
| Versão da especificação | CommonMark 0.31.2 + GFM |
📝 Sintaxe
## Título {#anchor}
[Texto do salto](#anchor)▶ Exemplo interativo
Edite o Markdown à esquerda e veja o resultado à direita
💡 Destaques
ℹ️ Note Sem {#id}, a maioria dos renderizadores gera um slug automático a partir do texto do título; a regra para títulos em chinês varia entre renderizadores, então em documentos longos vale especificar explicitamente.
⚠️ Warning O GitHub não suporta a sintaxe {#id}, mas gera âncoras automaticamente a partir do texto do título.
❓ Perguntas frequentes
P Como as âncoras automáticas são geradas?
R Inglês em minúsculas, espaços viram hífens, pontuação removida; para chinês, cada renderizador tem uma regra — o mais comum é manter o texto original.
P Este site suporta?
R As páginas de tutorial têm âncoras geradas automaticamente pelo construtor; o markdown-it-anchor pode ser ativado como opcional.
P O salto pode ter rolagem suave?
R Basta adicionar o CSS scroll-behavior: smooth; na camada do Markdown nada muda.
📚 Itens relacionados
TítulosNúcleo CommonMark