Encabezados

Actualizado el 12 nov 2026

Los encabezados generan automáticamente IDs de ancla para enlazarlos.

IDs generados automáticamente

## My Heading

Se renderiza como <h2 id="my-heading">My Heading</h2>. Los IDs se generan con un slug compatible con GitHub.

IDs de encabezado personalizados

Sobrescribe el ID generado automáticamente con la sintaxis {#custom-id}:

## My Heading {#custom-id}

Esto genera <h2 id="custom-id">My Heading</h2>. Enlázalo con #custom-id. Este mismo encabezado usa {#custom-ids}.

Niveles de encabezado

Usa h2–h4 para estructurar el contenido. El h1 está reservado para el título de la página.

Los encabezados más profundos (h5, h6) se admiten, pero no aparecen en el índice.

Control del índice

Controla si los encabezados aparecen en el índice mediante anotaciones.

Oculta un encabezado del índice sin dejar de mostrarlo en la salida renderizada:

## Visible Heading [!toc]

El encabezado se renderiza normalmente en la página, pero se excluye del índice.

Crea un encabezado solo para el índice, que aparece en el índice pero no en la salida renderizada:

## Hidden Heading [toc]

El encabezado aparece en el índice para la navegación, pero se elimina del contenido de la página.

Enlaces de ancla al pasar el cursor

Los encabezados con ID muestran un icono de enlace al pasar el cursor. El texto del encabezado es un enlace a su propia ancla: haz clic y la barra de direcciones tendrá una URL que puedes compartir.

Índice en línea

Inserta un índice en cualquier parte del contenido con la directiva ::toc:

::toc

Limita la profundidad con maxLevel:

::toc{maxLevel=2}

Se renderiza así: