Publicado em março de 2026

Índice de Conteúdo Automático para Markdown

Arquivos Markdown longos precisam de navegação. Um índice de conteúdo gerado a partir dos títulos torna qualquer documento escaneável. ShowMeMyMD gera um automaticamente — sem tags, sem plugins, sem ferramentas CLI.

## O Problema

Markdown Não Tem TOC Nativo

Markdown não tem uma sintaxe de índice de conteúdo. Não existe uma tag [TOC] na especificação. Algumas ferramentas suportam uma, a maioria não.

Então as pessoas contornam isso. Geradores CLI como markdown-toc e doctoc injetam Markdown de TOC no seu arquivo. O VS Code tem extensões para isso. O GitHub gera um automaticamente para arquivos README na web.

Nada disso é automático. Você modifica seu arquivo ou instala ferramentas. E quando muda um título, o TOC fica desatualizado até você rodar algo novamente.

## Como o ShowMeMyMD Resolve

Abra um Arquivo. O TOC Já Está Lá.

Abra qualquer arquivo .md com títulos — # até ###### — e o ShowMeMyMD gera um índice de conteúdo clicável automaticamente.

Sem tags para inserir. Sem plugins para instalar. Sem ferramentas CLI para executar. Sem configuração. Basta abrir seu arquivo e navegar.

Detalhe importante

O TOC é gerado no momento da renderização. Seu arquivo .md nunca é modificado. Mude um título e o TOC atualiza instantaneamente na próxima vez que você abrir o arquivo.

## Por Que Importa

Documentos Longos Precisam de Navegação

Qualquer documento com estrutura se beneficia de um TOC clicável. Pule para a seção que você precisa em vez de rolar centenas de linhas.

Arquivos README

Projetos open-source com instalação, uso, documentação de API e seções de contribuição. Pule direto para o que você precisa.

Documentação

Especificações técnicas, referências de API, runbooks. Um TOC transforma um muro de texto em um recurso navegável.

Atas de reunião

Itens de agenda, decisões, ações a tomar. Encontre a decisão da semana passada sem reler o documento inteiro.

Especificações técnicas

Decisões de arquitetura, documentos de design, RFCs. Navegue documentos complexos por seção.

## Alternativas

Outras Formas de Obter um TOC Markdown

TOC Manual

Escrever links Markdown para âncoras de títulos manualmente. Algo como [Instalação](#instalação) para cada seção. Tedioso de escrever, quebra quando títulos mudam, e você tem que mantê-lo sozinho.

`markdown-toc` (npm)

Uma ferramenta CLI que gera um TOC e insere como texto Markdown no seu arquivo. Funciona, mas requer Node.js, npm install e rodar o comando novamente toda vez que títulos mudam. Modifica seu arquivo fonte.

Extensões do VS Code

Várias extensões do VS Code adicionam geração de TOC. Funcionam dentro do VS Code, mas você precisa do VS Code aberto — uma IDE completa só para navegar um documento.

GitHub

O GitHub gera automaticamente um TOC para arquivos README na web. Clique no ícone de hambúrguer ao lado do nome do arquivo. Mas isso só funciona no GitHub.com — não para arquivos locais no seu Mac.

## O Jeito Simples

Basta Abrir Seu Arquivo

ShowMeMyMD gera um índice de conteúdo a partir dos seus títulos automaticamente. Sem modificação nos seus arquivos. Não-destrutivo. Funciona com qualquer estrutura de títulos de # até ######.

O TOC está sempre atualizado porque é gerado a partir do arquivo como ele está agora — não de um snapshot em cache ou um bloco injetado que pode estar desatualizado.

## Continue lendo

ShowMeMyMD: Visualizador de Markdown para Mac — visão completa dos recursos
Guia Rápido de Markdown — referência rápida para toda sintaxe
Visualizador de Markdown para Desenvolvedores — por que desenvolvedores usam o ShowMeMyMD

Pare de rolar. Comece a navegar.

$2.99. Compra única. Sem assinatura. Sem conta.