Gerador TOC Markdown
Gerar ligações de índice a partir de títulos Markdown
Markdown de entrada
TOC gerado
Exemplos de TOC Markdown
Gerar ligações de âncora a partir de títulos. Exemplo:
Títulos do manual do projecto
Markdown de entrada:
TOC gerado:
Utilize Amostra acima para carregar mais títulos.
O que é um gerador TOC Markdown?
Um índice (TOC) ajuda os leitores a navegar documentos longos. Em Markdown, os títulos usam # até ######. Um gerador TOC analisa os seus títulos e produz uma lista de ligações que saltam para cada secção. GitHub Flavored Markdown e muitos geradores de sites estáticos suportam ligações de âncora geradas a partir do texto do título.
Esta ferramenta executa-se no seu browser. Cole Markdown ou carregue um ficheiro; o TOC actualiza-se ao editar. Pode definir níveis mínimo e máximo de títulos (ex.: apenas H2–H4). Os slugs de âncora são criados a partir do texto do título e deduplicados quando se repetem. Para formatar Markdown: Formatador Markdown. Para converter para HTML: Markdown para HTML.
Como utilizar esta ferramenta
Colar ou carregar Markdown
Cole o seu Markdown no editor da esquerda ou clique em Carregar para carregar um ficheiro .md, .markdown ou .txt. Utilize Amostra para carregar títulos de exemplo. O TOC actualiza-se automaticamente.
Definir intervalo de níveis de título
Utilize Mín H1–H4 e Máx H3–H6 para incluir apenas certos níveis. Por exemplo, Mín H2 e Máx H4 omite H1 e H5–H6. Mantém documentos longos focados.
Copiar ou transferir o TOC
Copie o TOC gerado para a área de transferência ou transfira-o. Cole no início do seu README ou doc. Para lint de Markdown: Linter Markdown. Para ajuda de sintaxe: Guia rápida Markdown.
Quando a geração TOC ajuda
Ficheiros README no GitHub, sites de documentação e wikis beneficiam de um TOC. Os leitores podem saltar para secções sem fazer scroll. A especificação CommonMark define a sintaxe de títulos; GFM e a maioria dos renderizadores suportam ligações #anchor-slug. Geradores estáticos como Eleventy e VitePress frequentemente geram âncoras automaticamente.
Para criar tabelas a partir de CSV ou dados delimitados: Gerador de tabelas Markdown. Para referência de sintaxe: Guia rápida Markdown. Para Markdown para HTML: Markdown para HTML.
Perguntas frequentes
Como são criados os slugs de âncora?
Os títulos são convertidos em minúsculas, caracteres especiais removidos, espaços substituídos por hífens. Títulos duplicados recebem um sufixo numérico (ex.: #intro-1, #intro-2).
Funciona com GitHub?
Sim. O GitHub gera âncoras a partir dos títulos. Cole o TOC no início do seu README; as ligações funcionarão na vista renderizada.
Os títulos em blocos de código são incluídos?
Não. Os títulos dentro de blocos de código cercados (```) são ignorados para que exemplos de código não sejam confundidos com a estrutura do documento.
Posso limitar a profundidade?
Sim. Utilize os menus Mín/Máx nível. Por exemplo, Mín H2 e Máx H4 produz um TOC apenas com títulos H2, H3 e H4.
Os meus dados são enviados para um servidor?
Não. A geração TOC executa-se inteiramente no seu browser. Nenhum dado é enviado ou armazenado.
Ferramentas relacionadas
Saiba mais: CommonMark, especificação CommonMark, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, Eleventy, VitePress.