Cómo añadir una línea horizontal en Markdown

Una línea horizontal en Markdown es una de las herramientas de formato más sencillas y útiles que existen. Crea un separador visual entre secciones de contenido, haciendo que tus documentos sean más fáciles de leer y estén mejor organizados. Ya sea que estés escribiendo documentación, un archivo README o una publicación de blog, saber cómo usar Markdown para crear líneas horizontales mejorará la estructura de tus textos.

Esta guía de markdown explica todos los métodos y cubre el comportamiento en distintas plataformas para que puedas usar líneas horizontales con confianza en cualquier lugar.

¿Qué es una línea horizontal en Markdown?

Una línea horizontal, también llamada regla horizontal o ruptura temática, se muestra como una línea fina que se extiende a lo ancho de toda el área de contenido. En HTML, se traduce como una etiqueta <hr>. Los escritores la utilizan para separar temas, señalar un cambio de tono o dividir documentos largos en secciones más fáciles de digerir.

Tres formas de añadir una línea horizontal en Markdown

Markdown ofrece tres opciones de sintaxis que producen el mismo resultado. Cada una requiere tres o más caracteres consecutivos en su propia línea, sin ningún otro contenido.

Guiones

---

Tres guiones son la opción más popular. Son rápidos de escribir y visualmente limpios en archivos Markdown sin procesar.

Asteriscos

***

Tres asteriscos funcionan de forma idéntica. Algunos escritores los prefieren porque no existe el riesgo de crear accidentalmente un encabezado, algo que puede ocurrir con los guiones si hay texto en la línea inmediatamente superior.

Guiones bajos

___

Tres guiones bajos son la tercera opción. Se usan con menos frecuencia, pero son totalmente compatibles con todos los procesadores estándar de Markdown.

También puedes usar más de tres caracteres si prefieres un separador más visible en tu texto sin procesar:

----------

Esto se renderiza exactamente igual que tres guiones.

Un error común al añadir una línea horizontal en Markdown

Uno de los errores más frecuentes es colocar tres guiones directamente debajo de una línea de texto sin dejar una línea en blanco de por medio. Al hacer esto, la mayoría de los procesadores interpretan el texto de arriba como un encabezado en lugar de un párrafo seguido de una línea horizontal.

Por ejemplo, esto crea un encabezado en lugar de un separador:

Algo de texto
---

Para evitar esto, siempre deja una línea en blanco antes de tu regla horizontal:

Algo de texto

---

Esto asegura que el procesador los trate como dos elementos separados.

Línea horizontal en Markdown de GitHub

Si trabajas con GitHub, encontrarás líneas horizontales con frecuencia en archivos README, descripciones de pull requests y páginas wiki. Las tres opciones de sintaxis funcionan en el Markdown de GitHub. El uso de líneas horizontales en el Markdown de GitHub sigue la especificación CommonMark, por lo que el comportamiento es predecible y consistente.

Un caso de uso típico en un README de GitHub podría verse así:

## Características

Lista de características aquí.

---

## Instalación

Pasos de instalación aquí.

La línea horizontal en el Markdown de GitHub proporciona una separación visual limpia entre secciones principales sin depender únicamente de los encabezados.

Línea horizontal en Markdown de Discord

Discord admite un subconjunto limitado de Markdown en los mensajes de chat, pero las líneas horizontales no son una de las funciones compatibles. Si intentas escribir --- o *** en un mensaje de Discord, la aplicación no renderizará una regla horizontal. En su lugar, puede mostrar los caracteres como texto plano o interpretar los asteriscos como formato de negrita o cursiva.

Para solucionar la falta de líneas horizontales en el Markdown de Discord, muchos usuarios crean separadores visuales usando caracteres repetidos o emojis:

─────────────────

Esto no es Markdown real, pero cumple el mismo propósito visual en las conversaciones de Discord.

Cuándo usar una línea horizontal en Markdown

Las líneas horizontales funcionan mejor en situaciones específicas. Úsalas para separar un encabezado de documento o un bloque de metadatos del contenido principal, para dividir secciones no relacionadas dentro de un mismo documento o para marcar una transición de tema o narrativa. También son útiles en archivos README largos donde varias secciones principales se benefician de límites visuales claros.

Evita usarlas en exceso. Si cada sección de tu documento está separada por una línea horizontal, el efecto pierde impacto y el documento puede parecer entrecortado. Los encabezados por sí solos suelen ser suficientes para la mayoría de las necesidades estructurales, reservando las líneas horizontales para separaciones más significativas.

Líneas horizontales y front matter

Si usas generadores de sitios estáticos como Jekyll, Hugo o Astro, notarás que --- también sirve como delimitador para los bloques de front matter en la parte superior de los archivos Markdown:

---
title: Mi publicación de blog
date: 2026-05-11
---

El contenido comienza aquí.

El procesador distingue entre front matter y reglas horizontales según la posición. Los tres guiones al principio del archivo abren un bloque de front matter, mientras que los mismos caracteres en otra parte del documento crean una línea horizontal. Ten esto en cuenta para no romper accidentalmente tu front matter al añadir líneas --- adicionales cerca del inicio de tu archivo.

Referencia rápida

Aquí tienes un resumen de todas las formas de añadir una línea horizontal en Markdown:

• --- (tres guiones) es la sintaxis más común y ampliamente soportada.
• *** (tres asteriscos) funciona de forma idéntica y evita la creación accidental de encabezados.
• ___ (tres guiones bajos) es totalmente compatible, pero se usa con menos frecuencia.
• Siempre deja una línea en blanco encima de la regla horizontal para evitar que se interprete como un encabezado.
• Los tres métodos funcionan en el Markdown de GitHub.
• Discord no admite líneas horizontales en Markdown de forma nativa.

Reflexiones finales

Aprender a añadir una línea horizontal en Markdown lleva solo un momento, pero usarla bien requiere un poco de criterio. Elige un estilo de sintaxis, mantén la consistencia en todos tus documentos y recuerda incluir una línea en blanco encima de la regla para evitar sorpresas de formato. Con estos fundamentos en su lugar, tus documentos Markdown serán más limpios, más legibles y estarán mejor organizados.