Gerador de Índice

Um índice é a melhoria mais rápida para qualquer artigo com mais de mil palavras: o leitor passa os olhos, escolhe uma seção e pula até ela. Cole o seu Markdown e este gerador extrai cada título, transforma cada um em um link de âncora (em minúsculas, com os espaços substituídos por hifens) e produz uma lista aninhada com links que você pode colocar no topo da página.

Como construir um índice

  1. 1

    Escreva os seus títulos

    Use títulos ATX do Markdown: `# Título`, `## Seção`, `### Subseção`, até seis níveis de `#`.

  2. 2

    Cole o documento

    Cole o texto inteiro; o gerador analisa cada linha que começa com um a seis caracteres `#`.

  3. 3

    Gere

    Ele extrai cada título em ordem e mantém o seu nível.

  4. 4

    Obtenha a lista aninhada

    O resultado é uma lista com marcadores em Markdown, com dois espaços de recuo por nível, em que cada item leva à âncora do título.

  5. 5

    Copie o índice

    Cole-o logo abaixo da sua introdução para que o leitor veja a estrutura antes de rolar a página.

Como as âncoras dos títulos são geradas

O destino do link de cada título é construído a partir do seu texto com esta receita:

  1. Colocar o texto do título em minúsculas.
  2. Transliterar as letras acentuadas e não ASCII para a sua forma ASCII mais próxima.
  3. Remover a pontuação e substituir as sequências de espaços por hifens simples.

Assim, ## Why Rust? (2026 Edition) mantém o seu texto como rótulo do link e leva a #why-rust-2026-edition.

Observação: títulos idênticos produzem âncoras idênticas. O gerador não adiciona sufixos -2 / -3 aos duplicados, então se dois títulos coincidem exatamente, os dois links apontam para o mesmo ponto. Torne os títulos repetidos únicos se precisar que saltem separadamente.

Como fica o resultado

O nível do título define o recuo (dois espaços por nível) e cada item é um link Markdown:

Título Você escreve Linha do índice
Nível 1 # Intro - [Intro](#intro)
Nível 2 ## Setup - [Setup](#setup)
Nível 3 ### Notes - [Notes](#notes)

Dicas para um índice que o leitor realmente use

  • Decida sobre o H1. Cada título que você cola é incluído, o H1 também. Se você não quer o título da página no índice, deixe-o fora do texto colado ou apague essa primeira linha do resultado.
  • Mantenha-o raso. Todos os seis níveis são captados; se você quer apenas três, use somente de # a ### no seu texto.
  • Mantenha os títulos curtos. Títulos longos quebram no índice e ficam desordenados. Mire em 3 a 7 palavras.
  • Alinhe-se ao algoritmo de âncoras do seu CMS. Esta ferramenta cria âncoras em ASCII, em minúsculas e com hifens; se o seu CMS gera id="heading-one" enquanto a ferramenta escreve #heading-1, os saltos quebram sem aviso. Confira as âncoras renderizadas contra a sua plataforma.

Acessibilidade

  • Envolva o índice em um <nav aria-label="Table of contents">.
  • Marque a seção atual com aria-current="true" se você adicionar um scroll spy.
  • Mantenha os links acessíveis pelo teclado na ordem de leitura.

Perguntas frequentes

A causa mais comum é uma divergência entre a âncora no índice e o id que o CMS atribui ao título. Verifique o HTML renderizado: se o título tem id="why-rust" mas o seu link é #why-rust-edition, eles não vão corresponder.

Não com âncoras únicas. Dois títulos com o mesmo texto produzem a mesma âncora, então o segundo link salta para o primeiro título. Torne os títulos repetidos únicos, ou edite as âncoras depois, se precisar que levem a lugares separados.

Não diretamente: corte antes o texto de origem para removê-los, ou apague as linhas indesejadas do índice gerado antes de copiar. Cada título no texto colado, de # a ######, é incluído.

Não. Ele só reconhece títulos ATX do Markdown (linhas que começam com um a seis caracteres #). Converta primeiro o HTML <h1>-<h6> para Markdown se a sua origem for HTML.

O texto que você cola é enviado ao nosso servidor para construir o índice e depois devolvido. Ele não é armazenado nem registrado, e nada é mantido após a resposta.

Ferramentas relacionadas

Ferramenta disponível em outros idiomas