Ligne horizontale en Markdown : séparateurs, règles et solutions courantes

Pour ajouter une ligne horizontale en Markdown, placez trois tirets seuls sur une ligne, avec une ligne vide au-dessus et au-dessous :

Fin de la première section.

---

Début de la section suivante.

Le résultat est un séparateur entre deux paragraphes. Markdown l’appelle une rupture thématique ; HTML la représente par <hr>. Collez cet exemple dans la visionneuse Markdown pour vérifier le document rendu.

Trois façons d’écrire un séparateur

Toutes ces formes produisent une rupture thématique :

Source Markdown	Résultat
---	Ligne horizontale
***	Ligne horizontale
___	Ligne horizontale
* * *	Ligne horizontale

Utilisez au moins trois tirets, astérisques ou traits de soulignement identiques. Les espaces entre les marqueurs sont autorisés. Mélanger les types de marqueurs, ajouter du texte sur la même ligne ou n’utiliser que deux marqueurs ne crée pas de ligne. Ces règles de syntaxe proviennent de la spécification CommonMark des ruptures thématiques.

Le nombre de tirets ne détermine pas la largeur visuelle de la ligne. Une suite de 20 tirets et une suite de trois produisent le même élément HTML ; le style de la destination détermine son apparence.

Pourquoi ma ligne horizontale est-elle devenue un titre ?

Cette source ne place pas de séparateur sous « Notes de version » :

Notes de version
---

Elle crée un titre de niveau deux. Des tirets directement sous le texte d’un paragraphe peuvent former un titre Setext, et cette interprétation prime sur celle d’une ligne horizontale. Ajoutez une ligne vide pour séparer les deux :

Notes de version

---

Pour une section du document, un titre explicite est souvent plus clair :

## Notes de version

Le processus d’importation accepte désormais les fichiers CSV.

Utilisez les titres Markdown pour nommer les sections. Employez une ligne horizontale lorsque la transition elle-même compte, par exemple entre une lettre et une annexe.

Pourquoi le séparateur s’affiche-t-il en texte brut ?

Vérifiez la source autour de la ligne :

Symptôme	Cause probable	Correction
L’aperçu affiche --- dans un bloc de code	Quatre espaces au début d’un bloc autonome, ou un bloc de code délimité non fermé	Supprimer l’indentation ou fermer le bloc
L’aperçu affiche --	Seulement deux tirets	En utiliser trois ou plus
Du texte apparaît à côté des marqueurs	La ligne contient un autre texte	Placer les marqueurs seuls sur une ligne
La ligne s’affiche comme --- dans une phrase	Les marqueurs sont entre accents graves	Retirer les accents graves pour obtenir un séparateur
Le paragraphe précédent devient un titre	Aucune ligne vide au-dessus de ---	Insérer une ligne vide

Au niveau principal du document, jusqu’à trois espaces initiaux sont autorisés pour une rupture thématique. Dans une liste, l’indentation détermine aussi à quel élément appartient le contenu : vérifiez donc la liste environnante au lieu de supprimer tous les espaces.

Une ligne horizontale est différente d’un saut de ligne

Un séparateur divise des sections. Il ne fait pas simplement passer les mots suivants à la ligne.

Pour une adresse, utilisez un saut de ligne forcé :

120 Market Street\
San Francisco, CA

Pour un nouveau paragraphe, laissez une ligne vide. Pour séparer des sections, utilisez --- sur une ligne distincte. Le guide des sauts de ligne Markdown explique les espaces finaux, les barres obliques inverses et les différences de comportement de GitHub entre fichiers et commentaires.

Placer un séparateur dans une citation

Conservez le préfixe > sur chaque ligne, y compris le séparateur et les lignes vides :

> Proposition initiale.
>
> ---
>
> Contexte supplémentaire fourni lors de la relecture.

Le séparateur reste dans la citation. Retirer > devant la ligne peut terminer la citation et déplacer le séparateur dans le document extérieur. Consultez les exemples de citations pour les paragraphes multiples et les citations imbriquées.

Un séparateur de tableau n’est pas une ligne horizontale

Cette ligne appartient à un tableau :

| Format | Modifiable |
| --- | :---: |
| Markdown | Oui |

Les barres verticales et les deux-points facultatifs décrivent les colonnes. Ils n’insèrent pas de séparateur sur toute la largeur de la page. Utilisez le générateur de tableaux Markdown pour créer un tableau, ou le convertisseur CSV vers Markdown lorsque les données existent déjà dans un tableur.

Lignes horizontales et documents exportés

Une rupture thématique n’est pas une commande de saut de page. Un exportateur PDF ou Word décide où se terminent les pages selon ses règles de mise en page et de pagination. N’ajoutez pas de tirets supplémentaires en espérant faire commencer la section suivante sur une nouvelle page.

Sur une page web dont vous contrôlez le CSS, le <hr> généré peut être mis en forme dans la feuille de styles du site. Un service Markdown hébergé peut interdire le CSS personnalisé. Vérifiez la destination finale ou le document exporté, surtout si le séparateur porte un sens qui doit être conservé à l’impression.

Questions fréquentes

Faut-il des lignes vides autour d’une ligne horizontale ?

CommonMark ne les impose pas dans tous les contextes, mais elles évitent l’ambiguïté courante de --- comme titre et facilitent la lecture des fichiers sources.

Puis-je utiliser une balise HTML hr ?

<hr> fonctionne dans les moteurs de rendu autorisant le HTML brut. La syntaxe Markdown --- convient mieux à un document Markdown. L’éditeur MD File Viewer supprime les balises HTML fournies par l’utilisateur, tandis que la syntaxe Markdown du séparateur s’affiche normalement.

Comment afficher trois tirets sans créer de séparateur ?

Pour un exemple de syntaxe, écrivez du code en ligne : `---`. Pour du texte ordinaire sur une ligne isolée, échappez le premier tiret : \---.

Pour d’autres formes courantes de mise en forme, gardez l’aide-mémoire Markdown à portée de main.