O que é uma hierarquia de títulos Markdown?

Os títulos Markdown são definidos usando o símbolo # — um # para H1, dois para H2, até seis para H6. Eles formam a espinha dorsal estrutural de um documento, semelhante a um sumário. Um documento bem estruturado usa títulos em uma ordem lógica e aninhada: H1 como título de nível superior, H2 para seções principais, H3 para subseções e assim por diante.

Quando os títulos são usados fora de ordem — por exemplo, pulando de H2 diretamente para H4 — isso quebra o esboço semântico e pode prejudicar a acessibilidade (leitores de tela dependem da ordem dos títulos) e SEO (mecanismos de busca usam títulos para entender a hierarquia de conteúdo). Visualizar a hierarquia facilita a identificação desses problemas antes da publicação.

Descrição da ferramenta

Esta ferramenta analisa texto Markdown e exibe todos os títulos baseados em # como uma árvore interativa e recolhível. Você pode ver rapidamente como seu documento está estruturado, identificar níveis de títulos ignorados e contar quantos títulos de cada tipo estão presentes.

Os títulos dentro de blocos de código cercados (``` ou ~~~) são ignorados, portanto a saída reflete apenas a estrutura real do documento.

Exemplos

Entrada:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Árvore de saída:

H1  Getting Started
├── H2  Installation
│   ├── H3  Prerequisites
│   └── H3  Steps
└── H2  Configuration
H1  Advanced Usage
└── H2  Plugins

Recursos

  • Analisa todos os títulos H1–H6 de qualquer texto Markdown
  • Renderiza títulos como uma árvore interativa e recolhível com controles de expandir/recolher
  • Ignora títulos dentro de blocos de código cercados (``` e ~~~)
  • Mostra contagens de títulos por nível (H1–H6) e uma contagem total de títulos
  • Suporta profundidade de expansão inicial configurável

Casos de uso

  • Revisão de documentação — Verifique se um README longo ou página de documentação tem uma estrutura de títulos consistente e bem ordenada antes de publicar.
  • Auditoria de SEO — Verifique se o conteúdo destinado à web usa um único H1 e aninhamento lógico de H2/H3 para ajudar os rastreadores de mecanismos de busca a entender a estrutura da página.
  • Verificação de acessibilidade — Garanta que os níveis de títulos não sejam ignorados, que é um problema comum de acessibilidade sinalizado pelas diretrizes WCAG.

Como funciona

A ferramenta verifica a fonte Markdown linha por linha. Qualquer linha que comece com um a seis caracteres # seguidos por um espaço é tratada como um título. Um algoritmo de duas passagens primeiro coleta todos os títulos em ordem, depois constrói uma árvore rastreando uma pilha de nós pai abertos — cada novo título é aninhado sob o título de nível inferior mais próximo anterior.

Dicas

  • Cole um arquivo Markdown completo, incluindo front matter — a ferramenta ignora linhas que não são títulos, portanto o front matter YAML e o texto do corpo não afetarão a saída.
  • Use a configuração Profundidade de expansão inicial para recolher automaticamente níveis de aninhamento profundo e obter uma visão geral de alto nível primeiro.
  • Desmarque Expandir tudo antes de explorar um documento grande para começar recolhido e detalhar seções específicas.