Markdown TOC
Markdown TOC — se ejecuta en el navegador. No se guardan datos.
Generador de TOC Markdown
Introduce los valores y pulsa Calcular.
Cómo usar
- Pega el cuerpo en el campo Markdown. El documento necesita encabezados ATX (# título).
- Elige Nivel mínimo y Nivel máximo. El valor predeterminado es H2 a H4.
- Haz clic en Generar TOC y se crea una lista indentada con enlaces de ancla.
- Copiar al principio de un README o wiki. Puedes vaciar la entrada con Restablecer.
- Un # dentro de un bloque de código no se distingue, así que si un encabezado tipo comentario se mezcla en el TOC, edita el cuerpo.
Conceptos clave
TOC de Markdown sirve para hacer rápido enlaces de tabla de contenidos en un README de GitHub, un blog técnico o un sitio de docs. Recorre línea a línea de # a ###### y saca solo los niveles elegidos como - [título](#slug). El slug se pone en minúsculas con espacios convertidos en guiones, y el hangul se conserva. Los títulos repetidos reciben -2, -3. Es un generador de TOC markdown que construye contenidos de README de GitHub, barras laterales de wiki y saltos de docs solo a partir de encabezados ATX.
Los encabezados Setext subrayados (===, ---) no se reconocen. Las reglas de ancla pueden no coincidir al 100% con GitHub o algunos generadores de sitios estáticos, así que si un clic no funciona en la vista previa, comprueba las reglas del renderizador. La conversión ocurre solo en el navegador. Con niveles mín y máx puedes omitir títulos H1 e incluir solo H2–H4. Un # dentro de una valla de código puede confundirse con un encabezado.
Ejemplo
Pon ## Install, ### Requirements, ## Usage en el cuerpo y genera con mín H2 y máx H4: Install y Usage comparten la misma sangría, y Requirements entra un nivel. Los enlaces son slugs que conservan títulos hangul, como #설치 y #요구-사항. Si solo hay H1 y el mínimo es H2, el TOC puede quedar vacío. Pon ## Getting started y ### Install e Install se anida bajo Getting started, con enlaces #시작하기 y #설치.
Relacionado: Vista previa de Markdown · Markdown → HTML
Preguntas frecuentes
¿Los encabezados Setext (===) también entran en el TOC markdown?
No. Solo se admite el estilo # (ATX). Los títulos Setext subrayados no entran en el TOC, así que añade #.
¿Qué pasa con los slugs de ancla de títulos hangul?
El hangul se conserva y los espacios se convierten en hyphens. Los renderizadores pueden diferir. Si las anclas hangul se rompen en un sitio estático, comprueba las reglas del plugin de slugs.
¿Los comentarios # dentro de bloques de código se cuelan en el TOC?
Es un análisis de línea simple y no distingue bloques de código. Si un comentario # TODO se mezcla en el TOC, quítalo del cuerpo.
¿Es idéntico a un TOC de README de GitHub?
Similar, pero el recorte de caracteres especiales y las reglas de duplicados pueden no coincidir del todo. El recorte de caracteres especiales de GitHub puede diferir, así que prueba los clics en la vista previa.
¿Cuándo uso los niveles de encabezado mín y máx?
Usa los valores predeterminados cuando omites el título del documento (H1) y pones solo H2–H4 en el TOC. Para incluir desde H1, cambia el nivel mínimo a H1.
Si el mismo título aparece dos veces, ¿chocan las anclas?
A partir del segundo, se añade un número como -2 al slug. El mismo título recibe -2 en el segundo enlace para evitar un choque.
Última revisión: 2026-09-04