Generador de Tabla de Contenidos Markdown | Índice listo para pegar

Pega un documento Markdown y obtén una tabla de contenidos lista para colocar al principio de tu README o artículo. Elige la profundidad de encabezado, el estilo con viñetas o numerado y las anclas de GitHub, y el Markdown formateado aparece en el panel de salida.

💡 Sobre esta herramienta

Cuando mantienes documentación larga, mantener el índice al día se convierte en una tarea repetitiva: cada vez que reorganizas una sección, el índice escrito a mano deja de coincidir con el cuerpo. Un encabezado renombrado rompe su enlace, un nuevo ## nunca llega a la lista y el lector se topa con un enlace roto.

Esta herramienta reconstruye el índice a partir de los propios encabezados, de modo que la estructura siempre refleja el contenido. Para entender el funcionamiento conviene saber dos cosas. Primero, la sangría usa dos espacios y se calcula de forma relativa al encabezado menos profundo encontrado, así un documento que empieza en ## no arrastra un nivel vacío. Segundo, las anclas de GitHub siguen su regla de slug: minúsculas, espacios convertidos en guiones y todo lo que no sea a-z, 0-9, guion o guion bajo se elimina.

🧐 Preguntas Frecuentes

¿Incluye el H1? Eliges la profundidad de H2 a H6. Si dejas el título de la página como único H1 y empiezas el índice en H2, obtienes un esquema limpio del cuerpo sin repetir el título.

¿Funcionan de verdad las anclas de GitHub? Coinciden con el algoritmo de slug de GitHub, por lo que para encabezados en alfabeto latino los enlaces resuelven directamente. Los signos de puntuación y emojis se eliminan, igual que hace GitHub. Si un encabezado genera un ancla vacía, cambia el estilo a Ninguno para una lista de solo texto.

¿Confunde los comentarios # dentro de bloques de código? No. Todo lo que está dentro de un bloque abierto con ``` o ~~~ se omite hasta la marca de cierre, así que los comentarios de shell o de Python nunca se toman por encabezados.

¿Cómo se numeran las listas numeradas? Cada elemento se emite como 1.. Los renderizadores de Markdown numeran automáticamente las listas ordenadas, por lo que dejarlas todas como 1. en la fuente es la práctica habitual.

¿Qué determina la profundidad de la sangría? El nivel de encabezado menos profundo presente se toma como base y el resto se sangra en relación con él, así la jerarquía visual se mantiene tanto si el documento empieza en H2 como en H3.

📚 Cómo funciona la generación de anclas

El concepto clave detrás de un índice Markdown es el slug: una versión simplificada del texto del encabezado que sirve de destino del enlace. La conversión es determinista, lo que significa que el mismo texto produce siempre el mismo ancla; por eso un índice generado y los anclas reales de la página coinciden sin intervención manual. Entender este paso ayuda a depurar enlaces rotos: si un enlace no salta, casi siempre es porque el texto del encabezado se editó y el slug cambió. Regenerar el índice tras cada cambio de estructura evita ese desajuste y convierte la tabla de contenidos en un resultado derivado, no en algo que mantienes a mano.