Gerador de Sumário Markdown | Sumário pronto para colar

Cole um documento Markdown e receba um sumário pronto para colocar no topo do seu README ou artigo. Escolha a profundidade dos cabeçalhos, o estilo com marcadores ou numerado e as âncoras do GitHub, e o Markdown formatado aparece no painel de saída.

💡 Sobre esta ferramenta

Quem mantém uma documentação extensa conhece a tarefa repetitiva: a cada reorganização de uma seção, o sumário escrito à mão sai de sincronia com o corpo do texto. Um cabeçalho renomeado quebra o link da âncora, um novo ## nunca entra na lista, e o leitor esbarra num link morto.

Esta ferramenta reconstrói o sumário a partir dos próprios cabeçalhos, então a estrutura sempre acompanha o conteúdo. A indentação usa dois espaços e é calculada em relação ao cabeçalho menos profundo encontrado, de modo que um documento que começa em ## não arrasta um nível vazio. As âncoras do GitHub seguem a regra de slug do próprio GitHub — minúsculas, espaços viram hifens e tudo que não for a-z, 0-9, hífen ou sublinhado é removido — para que os links funcionem sem ajuste manual.

🧐 Perguntas frequentes

Ele inclui o H1? Você escolhe a profundidade de H2 a H6. Mantendo o título da página como único H1 e iniciando o sumário em H2, você obtém um esboço limpo do corpo sem repetir o título.

As âncoras do GitHub funcionam mesmo? Elas seguem o algoritmo de slug do GitHub, então para cabeçalhos em alfabeto latino os links resolvem diretamente. Pontuação e emojis são removidos, igual ao que o GitHub faz. Se um cabeçalho gerar uma âncora vazia, mude o estilo para Nenhuma e tenha uma lista só de texto.

Ele confunde comentários # dentro de blocos de código? Não. Tudo que estiver dentro de um bloco aberto com ``` ou ~~~ é ignorado até o fechamento correspondente, então prompts de shell e comentários de Python nunca são tomados por cabeçalhos.

Como as listas numeradas são numeradas? Cada item sai como 1.. Os renderizadores de Markdown numeram automaticamente as listas ordenadas, então deixar tudo como 1. na fonte é a prática usual e amigável ao diff.

O que determina a profundidade da indentação? O nível de cabeçalho menos profundo presente vira a base e o restante é indentado em relação a ele, preservando a hierarquia visual quer o documento comece em H2, quer em H3.

📚 Por que um sumário gerado vence o feito à mão

Em repositórios colaborativos, o sumário desatualizado é um dos defeitos de documentação mais comuns: as pessoas adicionam seções num pull request e esquecem da lista, então os links de âncora dão 404 para o próximo leitor. Gerar o sumário a partir dos cabeçalhos transforma a lista num resultado derivado, e não em algo que você mantém manualmente. Como o slug é calculado do mesmo jeito que o GitHub calcula, você evita o descompasso clássico entre um cabeçalho que diz "Configuração" e uma âncora digitada à mão como #config. O hábito certo é regenerar o sumário sempre que o esboço mudar, em vez de corrigir linha por linha.