¿Qué es una jerarquía de encabezados en Markdown?

Los encabezados de Markdown se definen usando el símbolo # — uno # para H1, dos para H2, hasta seis para H6. Forman la columna vertebral estructural de un documento, similar a una tabla de contenidos. Un documento bien estructurado utiliza encabezados en un orden lógico y anidado: H1 como título de nivel superior, H2 para secciones principales, H3 para subsecciones, y así sucesivamente.

Cuando los encabezados se utilizan fuera de orden — por ejemplo, saltando de H2 directamente a H4 — rompe el esquema semántico y puede afectar la accesibilidad (los lectores de pantalla dependen del orden de encabezados) y el SEO (los motores de búsqueda utilizan encabezados para entender la jerarquía de contenido). Visualizar la jerarquía facilita identificar estos problemas antes de publicar.

Descripción de la herramienta

Esta herramienta analiza texto Markdown y muestra todos los encabezados basados en # como un árbol interactivo y plegable. Puedes ver de un vistazo cómo está estructurado tu documento, identificar niveles de encabezado omitidos y contar cuántos encabezados de cada tipo están presentes.

Los encabezados dentro de bloques de código delimitados (``` o ~~~) se ignoran, por lo que el resultado solo refleja la estructura real del documento.

Ejemplos

Entrada:

# Comenzando

## Instalación

### Requisitos previos

### Pasos

## Configuración

# Uso avanzado

## Complementos

Árbol de salida:

H1  Comenzando
├── H2  Instalación
│   ├── H3  Requisitos previos
│   └── H3  Pasos
└── H2  Configuración
H1  Uso avanzado
└── H2  Complementos

Características

  • Analiza todos los encabezados H1–H6 de cualquier texto Markdown
  • Representa los encabezados como un árbol interactivo y plegable con controles de expandir/contraer
  • Omite encabezados dentro de bloques de código delimitados (``` y ~~~)
  • Muestra conteos de encabezados por nivel (H1–H6) y un conteo total de encabezados
  • Admite profundidad de expansión inicial configurable

Casos de uso

  • Revisión de documentación — Verifica que un README largo o una página de documentación tenga una estructura de encabezados consistente y bien ordenada antes de publicar.
  • Auditoría de SEO — Verifica que el contenido destinado a la web utilice un único H1 y anidamiento lógico de H2/H3 para ayudar a los rastreadores de motores de búsqueda a entender la estructura de la página.
  • Verificación de accesibilidad — Asegúrate de que los niveles de encabezado no se omitan, que es un problema de accesibilidad común señalado por las directrices WCAG.

Cómo funciona

La herramienta escanea la fuente Markdown línea por línea. Cualquier línea que comience con uno a seis caracteres # seguidos de un espacio se trata como un encabezado. Un algoritmo de dos pasadas primero recopila todos los encabezados en orden, luego construye un árbol rastreando una pila de nodos padre abiertos — cada nuevo encabezado se anida bajo el encabezado anterior más cercano de un nivel inferior.

Consejos

  • Pega un archivo Markdown completo, incluido el preámbulo — la herramienta ignora líneas que no son encabezados, por lo que el preámbulo YAML y el texto del cuerpo no afectarán el resultado.
  • Usa la configuración Profundidad de expansión inicial para contraer automáticamente niveles de anidamiento profundo y obtener una descripción general de alto nivel primero.
  • Desmarca Expandir todo antes de explorar un documento grande para comenzar contraído y profundizar en secciones específicas.