Separadores y reglas horizontales en Markdown

Un separador o regla horizontal en Markdown se utiliza para dividir secciones dentro de un documento, proporcionando una pausa visual entre contenidos. Es el equivalente al elemento <hr> en HTML.

13.1 Sintaxis básica

Existen varias formas de crear un separador en Markdown. Todas generan el mismo resultado:

  • Tres o más guiones (---)
  • Tres o más asteriscos (***)
  • Tres o más guiones bajos (___)

Ejemplos en Markdown:

---

***

___

Renderizado:

👉 Regla: deben usarse al menos tres caracteres y colocarse en una línea propia, sin texto alrededor.

13.2 Variantes y estilo visual

Aunque las tres formas (---, ***, ___) son equivalentes, algunos editores aplican diferencias de estilo:

  • ---: línea recta simple.
  • ***: algunos renderizadores la muestran con un estilo punteado o más marcado.
  • ___: suele renderizarse igual que ---.

👉 En la práctica, el más utilizado y estándar es ---.

13.3 Aplicaciones comunes

1. Dividir secciones de un documento

Ejemplo:

# Introducción
Este es el inicio del documento.

---

# Desarrollo
Aquí empieza una nueva sección.

Renderizado:

Introducción

Este es el inicio del documento.

Desarrollo

Aquí empieza una nueva sección.

2. Resaltar un cambio de tema

En tutoriales o apuntes, se puede usar una línea horizontal para marcar el paso de un tema a otro.

## Tema 1: Variables
Explicación de variables en Python.

---

## Tema 2: Condicionales
Explicación de if/else en Python.

3. Separar contenido visualmente en documentación

Por ejemplo, en un README.md para dividir instalación, uso y créditos.

# Mi Proyecto

## Instalación
Instrucciones de instalación aquí.

---

## Uso
Ejemplo de ejecución del programa.

4. Notas y comentarios destacados

Combinando separadores con citas (>) se pueden crear bloques visuales más claros.

---

> **Nota:** Este comando puede ser peligroso en producción.

---

Renderizado:

Nota: Este comando puede ser peligroso en producción.

13.4 Buenas prácticas

  • Usar separadores solo cuando se justifique: demasiados pueden ensuciar el documento.
  • En documentación técnica, emplearlos para marcar transiciones claras entre secciones.
  • En notas personales, ayudan a diferenciar apuntes o comentarios.
  • Elegir un estilo (---, *** o ___) y ser consistente.
  • No confundir --- (separador) con - (lista no ordenada).

👉 Consejo: si al escribir --- el editor crea un título H2 en vez de un separador, asegurate de que la línea no tenga texto arriba pegado.

13.5 Ejemplo completo

# Documentación de Ejemplo

## Introducción
Markdown es un lenguaje de marcado ligero y fácil de usar.

---

## Instalación
1. Descargar el proyecto.
2. Ejecutar el comando `npm install`.

***

## Uso
```python
print("Hola, Markdown!")
```

Créditos

Autor: Juan Pérez

Renderizado:

Documentación de Ejemplo

Introducción

Markdown es un lenguaje de marcado ligero y fácil de usar.

Instalación

  1. Descargar el proyecto.
  2. Ejecutar el comando npm install.

Uso

print("Hola, Markdown!")

Créditos

Autor: Juan Pérez

Conclusión

Los separadores en Markdown se crean con ---, *** o ___. Sirven para dividir secciones, resaltar cambios de tema o separar contenido. Son simples, portables y mejoran la organización visual del documento. El más usado y recomendado es ---, aunque los otros son igualmente válidos.

¿Listo para practicar lo aprendido? Visita el visor de Markdown y pon en práctica los conceptos.

Retornar