Che cos'è una gerarchia di intestazioni Markdown?

Le intestazioni Markdown sono definite utilizzando il simbolo # — uno # per H1, due per H2, fino a sei per H6. Formano la spina dorsale strutturale di un documento, simile a un indice. Un documento ben strutturato utilizza le intestazioni in un ordine logico e annidato: H1 come titolo di primo livello, H2 per le sezioni principali, H3 per le sottosezioni, e così via.

Quando le intestazioni vengono utilizzate fuori ordine — ad esempio, saltando direttamente da H2 a H4 — si rompe la struttura semantica e può danneggiare l'accessibilità (gli screen reader si basano sull'ordine delle intestazioni) e la SEO (i motori di ricerca utilizzano le intestazioni per comprendere la gerarchia dei contenuti). Visualizzare la gerarchia rende facile individuare questi problemi prima della pubblicazione.

Descrizione dello strumento

Questo strumento analizza il testo Markdown e visualizza tutte le intestazioni basate su # come un albero interattivo e comprimibile. Puoi vedere a colpo d'occhio come è strutturato il tuo documento, identificare i livelli di intestazione saltati e contare quante intestazioni di ogni tipo sono presenti.

Le intestazioni all'interno di blocchi di codice delimitati (``` o ~~~) vengono ignorate, quindi l'output riflette solo la struttura reale del documento.

Esempi

Input:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Albero di output:

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

Funzionalità

  • Analizza tutte le intestazioni da H1 a H6 da qualsiasi testo Markdown
  • Renderizza le intestazioni come un albero interattivo e comprimibile con controlli di espansione/compressione
  • Ignora le intestazioni all'interno di blocchi di codice delimitati (``` e ~~~)
  • Mostra i conteggi delle intestazioni per livello (H1–H6) e un conteggio totale delle intestazioni
  • Supporta la profondità di espansione iniziale configurabile

Casi d'uso

  • Revisione della documentazione — Verifica che un lungo README o una pagina di documentazione abbia una struttura di intestazioni coerente e ben ordinata prima della pubblicazione.
  • Audit SEO — Verifica che i contenuti destinati al web utilizzino un singolo H1 e un annidamento logico di H2/H3 per aiutare i crawler dei motori di ricerca a comprendere la struttura della pagina.
  • Controllo dell'accessibilità — Assicurati che i livelli di intestazione non vengano saltati, che è un problema di accessibilità comune segnalato dalle linee guida WCAG.

Come funziona

Lo strumento scansiona la fonte Markdown riga per riga. Qualsiasi riga che inizia con uno o sei caratteri # seguiti da uno spazio viene trattata come un'intestazione. Un algoritmo a due passaggi raccoglie prima tutte le intestazioni in ordine, quindi costruisce un albero tracciando uno stack di nodi padre aperti — ogni nuova intestazione viene annidata sotto l'intestazione di livello inferiore più vicina precedente.

Suggerimenti

  • Incolla un file Markdown completo, incluso il front matter — lo strumento ignora le righe non intestazione, quindi il front matter YAML e il testo del corpo non influenzeranno l'output.
  • Utilizza l'impostazione Profondità di espansione iniziale per comprimere automaticamente i livelli di annidamento profondo e ottenere prima una panoramica di alto livello.
  • Deseleziona Espandi tutto prima di esplorare un documento di grandi dimensioni per iniziare compresso e approfondire sezioni specifiche.