Cómo agregar una línea horizontal en Markdown

Una línea horizontal en Markdown es una de las herramientas de formato más simples pero útiles disponibles. Crea un divisor visual entre secciones de contenido, lo que hace que sus documentos sean más fáciles de escanear y estén más organizados. Ya sea que esté escribiendo documentación, un archivo README o una publicación de blog, saber cómo usar Markdown para divisores de líneas horizontales mejorará la estructura de su escritura.

Esta guía explica todos los métodos y cubre el comportamiento específico de la plataforma para que pueda utilizar líneas horizontales con confianza en cualquier lugar. Lea nuestra hoja de referencia de Markdown para obtener más información.

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

Una línea horizontal, también llamada regla horizontal o salto temático, se representa como una línea delgada que se extiende a lo largo de todo el ancho del área de contenido. En HTML, se traduce como una etiqueta <hr>. Los escritores lo utilizan para separar temas, señalar un cambio de tono o dividir documentos largos en secciones digeribles.

Tres formas de agregar una línea horizontal en Markdown

Markdown le ofrece tres opciones de sintaxis y todas producen el mismo resultado. Cada uno 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. Se escriben rápidamente y se limpian visualmente en archivos de rebajas sin formato.

Asteriscos

***

Tres asteriscos funcionan de manera idéntica. Algunos escritores los prefieren porque no existe el riesgo de crear accidentalmente un encabezado, lo que puede suceder con guiones si el texto aparece en la línea directamente arriba.

Subrayados

___

Tres guiones bajos son la tercera opción. Se utilizan con menos frecuencia pero son totalmente compatibles con todos los analizadores de rebajas estándar.

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

----------

Esto se representa exactamente de la misma manera que tres guiones.

Un error común al agregar rebajas de línea horizontal

Uno de los errores más frecuentes es colocar tres guiones directamente debajo de una línea de texto sin una línea en blanco entre ellos. Cuando hace esto, la mayoría de los analizadores interpretan el texto anterior como un título en lugar de un párrafo seguido de una línea horizontal.

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

Some text
---

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

Some text

---

Esto garantiza que el analizador los trate como dos elementos separados.

Línea horizontal de rebajas de GitHub

Si trabaja con GitHub, encontrará líneas horizontales con frecuencia en archivos README, descripciones de solicitudes de extracción y páginas wiki. Las tres opciones de sintaxis funcionan en GitHub Markdown. El uso de líneas horizontales en GitHub Markdown 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í:

## Features

List of features here.

---

## Installation

Installation steps here.

La línea horizontal en las rebajas de GitHub proporciona una separación visual clara entre las secciones principales sin depender únicamente de los títulos.

Línea horizontal de reducción de discordia

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

Para solucionar la falta de una línea horizontal de rebajas de Discord, muchos usuarios crean divisores visuales utilizando caracteres repetidos o emoji:

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

Esto no es una verdadera rebaja, pero tiene el mismo propósito visual en las conversaciones de Discord.

Cuándo utilizar una línea horizontal en Markdown

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

Evite el uso excesivo de ellos. Si cada sección de su documento está separada por una línea horizontal, el efecto pierde su impacto y el documento puede verse entrecortado. Los títulos por sí solos suelen ser suficientes para la mayoría de las necesidades estructurales, con líneas horizontales reservadas para cortes más importantes.

Líneas horizontales y portada

Si utiliza generadores de sitios estáticos como Jekyll, Hugo o Astro, notará que --- también sirve como delimitador para los bloques iniciales en la parte superior de los archivos de rebajas:

---
title: My Blog Post
date: 2026-05-11
---

Content starts here.

El analizador distingue entre reglas frontales y horizontales según la posición. Los guiones triples al principio de un archivo abren un bloque inicial, mientras que los mismos caracteres en otras partes del documento crean una línea horizontal. Tenga esto en cuenta para no romper accidentalmente el texto inicial agregando líneas --- adicionales cerca de la parte superior de su archivo.

Referencia rápida

Aquí hay un resumen de todas las formas de agregar una línea horizontal en Markdown:

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

Pensamientos finales

Aprender a agregar una línea horizontal en Markdown toma solo un momento, pero usarlo bien requiere un poco de juicio. Elija un estilo de sintaxis, mantenga la coherencia en todos sus documentos y recuerde incluir una línea en blanco encima de la regla para evitar sorpresas de formato. Con estos conceptos básicos implementados, sus documentos de rebajas estarán más limpios, más legibles y mejor organizados.