100 % privado — todo se ejecuta en tu navegador
Línea horizontal Markdown
Tres guiones, asteriscos o guiones bajos crean una línea horizontal Markdown. Haz clic en cada forma, mira el separador renderizarse en vivo y copia el que necesites.
Equipo de MD Viewer
Text above the divider
Text below the divider
Una línea horizontal Markdown — técnicamente un corte temático — es un separador a todo el ancho que estructura secciones de un documento. Se crea poniendo tres o más guiones, asteriscos o guiones bajos en su propia línea: ---, *** o ___. El patio de juego de arriba te deja hacer clic en cada forma y ver la línea horizontal Markdown aparecer al instante, con la fuente a la izquierda y el separador renderizado a la derecha.
La sintaxis parece trivial, pero dos detalles atrapan a todos. Primero, la línea que lleva tu línea horizontal Markdown necesita una línea en blanco antes — si no, un --- justo debajo de texto convierte ese texto en encabezado. Segundo, los guiones bajos no pueden llevar espacios entre ellos, mientras que guiones y asteriscos sí. El ejemplo de ambigüedad de título del patio de juego demuestra la trampa en vivo, para que la reconozcas en tus archivos antes de que llegue a un README.
Todo se ejecuta localmente en el navegador: edita los ejemplos, añade tu propio texto encima y debajo del separador, pulsa Copiar Markdown y pega la línea horizontal Markdown funcional donde quieras. Bajo la herramienta encontrarás la tabla de sintaxis completa, los pasos para insertar separadores limpiamente, la trampa del encabezado Setext explicada y las respuestas a las preguntas más frecuentes sobre reglas horizontales.
Referencia de sintaxis de la línea horizontal Markdown
| Escribes | Qué se renderiza |
|---|---|
| --- | Una línea horizontal Markdown (corte temático) |
| *** | Una línea horizontal Markdown de asteriscos |
| ___ | Una línea horizontal Markdown de guiones bajos |
| - - - | Guiones con espacios también forman separador |
| ---------- | Más de tres caracteres funciona igual |
| Título --- | No es separador — se renderiza como encabezado H2 (Setext) |
Cómo insertar una línea horizontal Markdown correctamente
- 1
Deja una línea en blanco encima
La línea en blanco despega el marcador del párrafo anterior. Sin ella, un --- bajo una línea de texto redefine esa línea como encabezado en lugar de trazar la línea horizontal Markdown.
- 2
Escribe tres marcadores o más
Elige ---, *** o ___ y repite el carácter al menos tres veces. La línea horizontal Markdown se renderiza idéntica sin importar la longitud; la mayoría de guías de estilo se quedan en exactamente tres.
- 3
Sigue con una línea en blanco
Una línea en blanco tras el separador impide que el párrafo siguiente se pegue — y evita que la línea horizontal Markdown se lleve a una lista de guiones cercana hacia la ambigüedad.
- 4
Previsualiza y copia
Usa los chips de arriba para probar los tres tipos de marcador, y Copiar Markdown para llevarte la fuente exacta. La línea horizontal Markdown pegada se renderiza en toda plataforma CommonMark.
La trampa Setext: cuándo --- no es una línea horizontal
Debajo de un párrafo, una línea de guiones cambia de sentido por completo: se convierte en subrayado de encabezado Setext y asciende el texto de arriba a H2. Así, Texto seguido inmediatamente de --- produce un encabezado grande, mientras que Texto, línea en blanco y --- producen un párrafo y una línea horizontal Markdown. Es la confusión más común alrededor de las reglas horizontales, y el ejemplo de ambigüedad de arriba muestra ambos resultados con una línea de diferencia.
La misma interacción explica un fallo más sutil: una lista de guiones justo encima de un --- puede, según el renderizador, pegar el separador a la lista. Líneas en blanco a ambos lados son la solución — cierran todas las construcciones vecinas antes de que empiece la línea horizontal Markdown. Si un separador se renderiza raro alguna vez, busca primero líneas en blanco que falten.
Errores de la línea horizontal Markdown y sus correcciones
Título ---
Título ---
Sin la línea en blanco, los guiones convierten Título en un encabezado H2. La línea en blanco restaura la línea horizontal Markdown buscada.
_ _ _
___
Los guiones bajos con espacios no forman separador — incluso pueden dar énfasis al texto. Deja los guiones bajos pegados; guiones y asteriscos admiten espacios.
Dos guiones --
Tres guiones ---
Una línea horizontal Markdown necesita al menos tres caracteres marcador. Dos guiones aparecen como texto literal.
Separadores para la estructura, no decoración
Una línea horizontal Markdown señala una frontera mayor — apéndice, corte de registro de cambios, cambio de tema. Un documento donde cada subsección tiene separador se lee saturado: tira primero de encabezados y reserva la línea horizontal Markdown para las costuras de verdad.
Dónde luce la línea horizontal Markdown
La documentación se lee mejor con costuras honestas. Las notas de versión ponen una línea horizontal Markdown entre cada versión para que quien busca la v2.4 salte visualmente de bloque en bloque; las guías largas ponen una antes del apéndice o la bibliografía; las notas personales la usan para separar días o temas en un único archivo. Como la línea horizontal Markdown se renderiza como estilo y no como carácter, se adapta a cada tema — modo oscuro, impresión, móvil — sin trabajo extra del autor.
El combo clásico sigue siendo separador más encabezados: un H2 anuncia la sección, la línea horizontal Markdown marca los grandes movimientos, y el espacio en blanco se ocupa del resto. Usada así, hace trabajo estructural de verdad — le dice al lector que esto es un capítulo nuevo, no un párrafo nuevo — exactamente la señal que un separador debe transmitir. Un consejo final para revisores de pull requests: la línea justo encima de un --- delata al instante si se pretendía un separador o un encabezado; con líneas en blanko en ambos lados, la revisión se despacha en segundos.
Preguntas frecuentes
Fuentes y citas de especificación
“A line consisting of optionally up to three spaces of indentation, followed by a sequence of three or more matching -, _, or * characters, each followed optionally by any number of spaces or tabs, forms a thematic break.”