Un índice Markdown que lleva a la sección correcta
Un buen índice no se limita a enumerar títulos: cada enlace debe coincidir con el ancla que genera el visor de Markdown. Esta herramienta prepara el TOC, mantiene la jerarquía del documento y te permite revisar el resultado antes de copiarlo.
Cómo generar un índice Markdown para README.md en tres pasos
Este generador de tabla de contenidos Markdown funciona directamente en el navegador, sin instalar una extensión ni ejecutar comandos. El contenido se procesa en tu dispositivo.
Pega el contenido o sube el archivo
Añade el texto Markdown al editor o abre un archivo .md o .markdown. La herramienta detectará los encabezados reales del documento.
Elige qué niveles deben aparecer
Selecciona el intervalo de H1 a H6. Para un README habitual suele bastar con incluir H2 y H3, de modo que el índice sea útil sin hacerse interminable.
Comprueba y copia el índice
Comprueba los enlaces en la vista previa. Después, copia el índice generado y pégalo en el lugar que prefieras del documento Markdown.
Para README, documentación técnica y apuntes largos
En un README.md, el lector suele buscar instalación, configuración, uso y referencia de la API. Un índice enlazado le permite saltar a la parte que necesita sin recorrer todo el repositorio.
También resulta práctico en guías internas, wikis y apuntes extensos. El generador conserva la relación entre encabezados y subencabezados para que se entienda la estructura de un vistazo.
README de GitHub
Crea enlaces con anclas de estilo GitHub y numera los identificadores cuando hay títulos repetidos.
Documentación técnica
Selecciona solo los niveles relevantes para que una guía extensa mantenga un índice claro y manejable.
Notas y material de estudio
Convierte los apartados de un tema en accesos directos sin redactar cada enlace a mano.
Por qué fallan algunos enlaces del índice en GitHub
El texto visible y el destino del enlace no son lo mismo. Para crear el ancla, se pasa el encabezado a minúsculas, se elimina la puntuación y se sustituyen los espacios por guiones. Por ejemplo, ## Configuración rápida se enlaza como #configuración-rápida.
Los títulos repetidos necesitan destinos distintos. Si aparecen dos apartados llamados Ejemplo, sus anclas serán #ejemplo y #ejemplo-1. El generador resuelve estas colisiones y no interpreta como encabezados los símbolos # que estén dentro de bloques de código.
Hemos comprobado los siguientes casos mediante pruebas automatizadas de la implementación actual. Los resultados muestran cómo trata los signos de apertura, los acentos, la ñ, los emoji y las colisiones entre slugs. Verifican esta herramienta, no el renderizador de producción de GitHub ni el resultado en otras plataformas. Última comprobación: agosto de 2026.
| Encabezado probado | Contexto | Ancla generada |
|---|---|---|
¿Qué es Markdown? | Signos de apertura | #qué-es-markdown |
Diseño y UX | Eñe | #diseño-y-ux |
Año 2026 | Eñe y números | #año-2026 |
🚀Inicio rápido | Emoji | #inicio-rápido |
Uso | Primera aparición | #uso |
Uso | Segunda aparición | #uso-1 |
Uso-1 | Después de los dos anteriores | #uso-1-1 |
Qué debes comprobar en GitHub, GitLab, Obsidian, Pandoc y MkDocs
La salida sigue reglas de anclas de estilo GitHub, pero Markdown no define un algoritmo universal para convertir encabezados en identificadores. La especificación de CommonMark define la sintaxis de los encabezados, mientras que la documentación oficial de GitHub explica sus enlaces de sección. Para otros flujos de trabajo, consulta también la sintaxis oficial de Obsidian y la opción --toc de Pandoc. Comprueba siempre el archivo en la plataforma donde vayas a publicarlo.
| Plataforma | Recomendación práctica |
|---|---|
| GitHub | Publica el README y prueba los enlaces con títulos repetidos o Unicode |
| GitLab | Verifica los slugs en la vista renderizada, especialmente los duplicados |
| Obsidian | Prueba los enlaces a encabezados dentro de la aplicación y distingue los wikilinks |
| Pandoc | Si necesitas un TOC automático al exportar, valora su opción nativa --toc |
| MkDocs | Comprueba la configuración, las extensiones y el tema usados para generar las anclas |
Revisa la sintaxis y el documento completo
Consulta la guía rápida de Markdown si necesitas corregir encabezados, crea destinos con el generador de enlaces Markdown y prueba el README completo en la vista previa de Markdown. Si el documento se publicará en una web, también puedes usar el conversor de Markdown a HTML.