Línea horizontal en Markdown: separadores, reglas y soluciones habituales

Para añadir una línea horizontal en Markdown, escribe tres guiones en una línea independiente, con una línea en blanco encima y debajo:

Final de la primera sección.

---

Inicio de la siguiente sección.

El resultado es un separador entre dos párrafos. Markdown lo denomina separación temática; HTML lo representa con <hr>. Pega el ejemplo en el visor de Markdown para comprobar el documento renderizado.

Tres formas de escribir un separador

Todas estas formas producen una separación temática:

Código Markdown	Resultado
---	Línea horizontal
***	Línea horizontal
___	Línea horizontal
* * *	Línea horizontal

Utiliza al menos tres guiones, asteriscos o guiones bajos del mismo tipo. Se permiten espacios entre los marcadores. Mezclar tipos, añadir texto en la misma línea o utilizar solo dos marcadores no crea una línea. Estas reglas de sintaxis proceden de la especificación de separaciones temáticas de CommonMark.

El número de guiones no determina el ancho visual. Una línea de 20 guiones y otra de tres producen el mismo elemento HTML; el estilo del destino determina su apariencia.

¿Por qué mi línea horizontal se convirtió en un encabezado?

Este código no coloca un separador debajo de «Notas de la versión»:

Notas de la versión
---

Crea un encabezado de nivel dos. Los guiones directamente debajo de un párrafo pueden formar un encabezado Setext, y esa interpretación tiene prioridad sobre una línea horizontal. Añade una línea en blanco para separarlos:

Notas de la versión

---

Para una sección del documento, un encabezado explícito suele resultar más claro:

## Notas de la versión

El proceso de importación ahora admite archivos CSV.

Utiliza encabezados Markdown para identificar secciones. Usa una línea horizontal cuando la transición en sí sea importante, por ejemplo, para separar una carta de un apéndice.

¿Por qué el separador aparece como texto sin formato?

Comprueba el código que rodea la línea:

Síntoma	Causa probable	Solución
La vista previa muestra --- dentro de un bloque de código	Cuatro espacios al principio de un bloque independiente o un bloque delimitado sin cerrar	Quitar la sangría o cerrar el bloque
La vista previa muestra --	Solo hay dos guiones	Utilizar tres o más
Aparece texto junto a los marcadores	La línea contiene otro texto	Poner los marcadores en su propia línea
La línea aparece como --- dentro de una frase	Los marcadores están entre acentos graves	Quitar los acentos graves si se pretende crear un separador
El párrafo anterior se convierte en encabezado	No hay una línea en blanco encima de ---	Insertar una línea en blanco

En el nivel superior del documento, una separación temática admite hasta tres espacios iniciales. Dentro de listas, la sangría también determina a qué elemento pertenece el contenido, así que comprueba la lista circundante en lugar de eliminar todos los espacios.

Una línea horizontal no es un salto de línea

Un separador divide secciones. No se limita a mover las palabras siguientes a una nueva línea.

Para una dirección, utiliza un salto de línea forzado:

120 Market Street\
San Francisco, CA

Para un nuevo párrafo, deja una línea vacía. Para separar secciones, utiliza --- en una línea independiente. La guía de saltos de línea en Markdown explica los espacios finales, las barras invertidas y el comportamiento diferente de GitHub en archivos y comentarios.

Colocar un separador dentro de una cita

Mantén el prefijo > en cada línea, incluidas la del separador y las vacías:

> Propuesta original.
>
> ---
>
> Contexto adicional de quien la revisó.

El separador permanece dentro de la cita. Quitar > de la línea puede cerrar la cita y mover el separador al documento exterior. Consulta los ejemplos de citas para varios párrafos y citas anidadas.

Un separador de tabla no es una línea horizontal

Esta línea pertenece a una tabla:

| Formato | Editable |
| --- | :---: |
| Markdown | Sí |

Las barras verticales y los dos puntos opcionales describen las columnas. No insertan un separador de ancho completo. Utiliza el generador de tablas Markdown para crear una tabla, o el convertidor CSV a Markdown cuando los datos ya estén en una hoja de cálculo.

Líneas horizontales y documentos exportados

Una separación temática no es una orden de salto de página. Un exportador PDF o Word decide dónde terminan las páginas según sus reglas de diseño y paginación. No añadas más guiones esperando que la siguiente sección empiece en una página nueva.

En una página web cuyo CSS controles, puedes dar estilo al <hr> generado desde la hoja de estilos del sitio. Un servicio Markdown alojado puede no permitir CSS personalizado. Comprueba el destino final o el documento exportado, especialmente si el separador transmite un significado que debe conservarse al imprimir.

Preguntas frecuentes

¿Necesito líneas en blanco alrededor de una línea horizontal?

CommonMark no las exige en todos los contextos, pero usarlas evita la habitual ambigüedad de --- como encabezado y facilita la lectura del archivo fuente.

¿Puedo utilizar una etiqueta HTML hr?

<hr> funciona en renderizadores que permiten HTML sin procesar. La sintaxis Markdown --- es más adecuada para un documento Markdown. El editor de MD File Viewer elimina las etiquetas HTML aportadas por el usuario, mientras que la sintaxis de separador Markdown se renderiza normalmente.

¿Cómo muestro tres guiones sin crear un separador?

Para un ejemplo de sintaxis, escribe código en línea: `---`. Para texto normal en una línea independiente, escapa el primer guion: \---.

Para otros patrones habituales de formato, ten a mano la chuleta de Markdown.