Warning Estructura de encabezados — faltante, duplicada u omitida

Por qué las páginas necesitan exactamente un H1 claro y un orden lógico H1→H2→H3, y cómo navegan por encabezados los usuarios de lector de pantalla.

El validador revisa tres cosas: si la página no tiene ningún <h1> (missing-h1, advertencia), si tiene más de uno (multiple-h1, informativo), y si los niveles de encabezado saltan — por ejemplo de H2 directo a H4 (heading-skip, advertencia).

Ejemplo

<!-- Incorrecto: se salta el H2 -->
<h1>Título del artículo</h1>
<h3>Subsección</h3>

<!-- Correcto -->
<h1>Título del artículo</h1>
<h2>Sección</h2>
<h3>Subsección</h3>

Por qué importa

Los usuarios de lector de pantalla suelen navegar una página saltando entre encabezados — la mayoría de los lectores de pantalla tienen un atajo dedicado que muestra una lista de todos los encabezados, permitiendo escanear la estructura de una página igual que un usuario vidente escanea visualmente con los tamaños de fuente. Un nivel omitido (de H2 a H4) hace que ese esquema resulte confuso, dando a entender un nivel de anidamiento que en realidad no existe en el contenido. Un H1 faltante significa que no hay un tema claro de nivel superior; varios H1 son técnicamente válidos en el modelo de esquema de HTML5 (cada uno puede representar una nueva raíz de sección) pero vale la pena revisarlos con cuidado — la mayoría de las páginas se leen más claro con exactamente uno.

Frequently asked questions

¿Una página puede tener más de un H1 alguna vez?

Sí — el modelo de secciones de HTML5 permite varios H1, por ejemplo uno por cada <article> en una página que lista varios artículos. Se marca como informativo, no como error, precisamente porque a veces es intencional. Aun así, para una página de un solo tema, un H1 hace la estructura más clara.

¿El orden de encabezados es sobre el tamaño visual o la estructura del documento?

Estructura, no tamaño. Los encabezados se pueden estilizar a cualquier tamaño de fuente con CSS — lo que importa para accesibilidad y SEO es que los niveles (H1, H2, H3...) reflejen el anidamiento real de temas y subtemas, sin importar qué tan grandes se rendericen.