Com afegir una línia horitzontal a Markdown

Una línia horitzontal a Markdown és una de les eines de format més senzilles però alhora més útils. Crea un separador visual entre seccions de contingut, fent que els documents siguin més fàcils de fullejar i més organitzats. Tant si estàs escrivint documentació, un fitxer README o una entrada de blog, saber com utilitzar Markdown per fer separadors de línia horitzontal millorarà l'estructura dels teus textos.

Aquesta guia explica tots els mètodes i tracta el comportament específic de cada plataforma perquè puguis utilitzar línies horitzontals amb confiança a qualsevol lloc. Llegeix la nostra fitxa de referència de Markdown per a més informació.

Què és una línia horitzontal a Markdown?

Una línia horitzontal, també anomenada regla horitzontal o salt temàtic, es renderitza com una línia fina que s'estén per tota l'amplada de l'àrea de contingut. En HTML, es tradueix com una etiqueta <hr>. Els escriptors la fan servir per separar temes, indicar un canvi de to o trencar documents llargs en seccions més manejables.

Tres maneres d'afegir una línia horitzontal a Markdown

Markdown t'ofereix tres opcions de sintaxi que produeixen el mateix resultat. Cadascuna requereix tres o més caràcters consecutius en una línia pròpia, sense cap altre contingut.

Guions

---

Tres guions són l'opció més habitual. Són ràpids d'escriure i queden nets visualment als fitxers Markdown en brut.

Asteriscs

***

Tres asteriscs funcionen exactament igual. Alguns escriptors els prefereixen perquè no hi ha risc de crear un encapçalament sense voler, cosa que pot passar amb els guions si hi ha text just a la línia de sobre.

Guions baixos

___

Tres guions baixos són la tercera opció. S'utilitzen menys, però són plenament compatibles amb tots els analitzadors de Markdown estàndard.

També pots utilitzar més de tres caràcters si vols un separador més visible al text en brut:

----------

Es renderitza exactament igual que tres guions.

Un error habitual en afegir una línia horitzontal a Markdown

Un dels errors més freqüents és col·locar tres guions just sota una línia de text sense deixar una línia en blanc entremig. Quan ho fas així, la majoria d'analitzadors interpreten el text de sobre com un encapçalament en lloc d'un paràgraf seguit d'una línia horitzontal.

Per exemple, això crea un encapçalament en lloc d'un separador:

Some text
---

Per evitar-ho, deixa sempre una línia en blanc abans de la regla horitzontal:

Some text

---

D'aquesta manera l'analitzador els tracta com dos elements separats.

Línia horitzontal a Markdown a GitHub

Si treballes amb GitHub, et trobaràs línies horitzontals sovint a fitxers README, descripcions de pull requests i pàgines de wiki. Les tres opcions de sintaxi funcionen al Markdown de GitHub. L'ús de la línia horitzontal al Markdown de GitHub segueix l'especificació CommonMark, així que el comportament és predictible i consistent.

Un cas d'ús típic a un README de GitHub podria ser així:

## Features

List of features here.

---

## Installation

Installation steps here.

La línia horitzontal al Markdown de GitHub proporciona un trencament visual net entre seccions importants sense haver de dependre només dels encapçalaments.

Línia horitzontal a Markdown a Discord

Discord admet un subconjunt limitat de Markdown als missatges de xat, però les línies horitzontals no en formen part. Si intentes escriure --- o *** en un missatge de Discord, l'aplicació no renderitzarà cap regla horitzontal. En canvi, pot ser que mostri els caràcters com a text pla o que interpreti els asteriscs com a format de negreta o cursiva.

Per esquivar la manca de línies horitzontals de Markdown a Discord, molts usuaris creen separadors visuals amb caràcters repetits o emojis:

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

No és Markdown de debò, però fa la mateixa funció visual a les converses de Discord.

Quan utilitzar una línia horitzontal a Markdown

Les línies horitzontals funcionen millor en situacions concretes. Fes-les servir per separar la capçalera o el bloc de metadades del contingut principal, per dividir seccions no relacionades dins d'un mateix document o per marcar una transició de narrativa o de tema. També són útils en fitxers README llargs on diverses seccions importants es beneficien de límits visuals contundents.

Evita abusar-ne. Si separes totes les seccions del document amb una línia horitzontal, l'efecte perd força i el document pot semblar entretallat. Sovint, els encapçalaments per si sols són suficients per a la majoria de necessitats estructurals, i les línies horitzontals queden reservades per a trencaments més significatius.

Línies horitzontals i front matter

Si utilitzes generadors de llocs estàtics com Jekyll, Hugo o Astro, t'adonaràs que --- també serveix de delimitador per als blocs de front matter al principi dels fitxers Markdown:

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

Content starts here.

L'analitzador distingeix entre front matter i regles horitzontals segons la posició. Els tres guions just al principi d'un fitxer obren un bloc de front matter, mentre que els mateixos caràcters en qualsevol altre lloc del document creen una línia horitzontal. Tingues-ho present perquè no facis malbé el front matter sense voler afegint línies --- extra a prop del principi del fitxer.

Referència ràpida

Aquí tens un resum de totes les maneres d'afegir una línia horitzontal a Markdown:

• --- (tres guions) és la sintaxi més habitual i àmpliament compatible.
• *** (tres asteriscs) funciona exactament igual i evita la creació accidental d'encapçalaments.
• ___ (tres guions baixos) és plenament compatible però s'utilitza menys.
• Deixa sempre una línia en blanc sobre la regla horitzontal per evitar que s'interpreti com un encapçalament.
• Els tres mètodes funcionen al Markdown de GitHub.
• Discord no admet línies horitzontals de Markdown de manera nativa.

Reflexions finals

Aprendre a afegir una línia horitzontal a Markdown només et portarà un moment, però utilitzar-la bé requereix una mica de criteri. Tria un estil de sintaxi, sigues conseqüent al llarg dels documents i recorda d'incloure una línia en blanc sobre la regla per evitar sorpreses de format. Amb aquests fonaments controlats, els teus documents Markdown seran més nets, llegibles i ben organitzats.