Comment ajouter une ligne horizontale dans Markdown

Une ligne horizontale dans Markdown est l'un des outils de formatage les plus simples mais les plus utiles disponibles. Il crée un séparateur visuel entre les sections de contenu, rendant vos documents plus faciles à numériser et plus organisés. Que vous écriviez de la documentation, un fichier README ou un article de blog, savoir comment utiliser le markdown pour les séparateurs de lignes horizontales améliorera la structure de votre écriture.

Ce guide explique chaque méthode et couvre le comportement spécifique à la plate-forme afin que vous puissiez utiliser les lignes horizontales en toute confiance n'importe où. Lisez notre aide-mémoire Markdown pour en savoir plus.

Qu'est-ce qu'une ligne horizontale dans Markdown ?

Une ligne horizontale, également appelée règle horizontale ou saut thématique, s'affiche sous la forme d'une fine ligne s'étendant sur toute la largeur de votre zone de contenu. En HTML, cela se traduit par une balise <hr>. Les écrivains l'utilisent pour séparer les sujets, signaler un changement de ton ou diviser de longs documents en sections compréhensibles.

Trois façons d'ajouter une ligne horizontale dans Markdown

Markdown vous propose trois options de syntaxe qui produisent toutes le même résultat. Chacun nécessite trois caractères consécutifs ou plus sur sa propre ligne sans autre contenu.

Tirets

---

Trois tirets sont le choix le plus populaire. Ils sont rapides à saisir et nettoient visuellement les fichiers de démarques brutes.

Astérisques

***

Trois astérisques fonctionnent de manière identique. Certains auteurs les préfèrent car il n'y a aucun risque de créer accidentellement un titre, ce qui peut arriver avec des traits d'union si le texte apparaît sur la ligne directement au-dessus.

Soulignements

___

Trois traits de soulignement constituent la troisième option. Ils sont moins couramment utilisés mais entièrement pris en charge par tous les analyseurs de démarques standards.

Vous pouvez également utiliser plus de trois caractères si vous préférez un séparateur plus visible dans votre texte brut :

----------

Cela s'obtient exactement de la même manière que trois traits d'union.

Une erreur courante lorsque vous ajoutez une démarque de ligne horizontale

L’une des erreurs les plus fréquentes consiste à placer trois traits d’union directement sous une ligne de texte sans aucune ligne vide entre les deux. Lorsque vous faites cela, la plupart des analyseurs interprètent le texte ci-dessus comme un titre plutôt que comme un paragraphe suivi d'une ligne horizontale.

Par exemple, cela crée un titre au lieu d'un séparateur :

Some text
---

Pour éviter cela, laissez toujours une ligne vide avant votre règle horizontale :

Some text

---

Cela garantit que l'analyseur les traite comme deux éléments distincts.

Ligne horizontale de démarque GitHub

Si vous travaillez avec GitHub, vous rencontrerez fréquemment des lignes horizontales dans les fichiers README, les descriptions de demandes d'extraction et les pages wiki. Les trois options de syntaxe fonctionnent dans le markdown GitHub. L'utilisation des lignes horizontales dans le démarque GitHub suit la spécification CommonMark, le comportement est donc prévisible et cohérent.

Un cas d'utilisation typique dans un fichier README GitHub pourrait ressembler à ceci :

## Features

List of features here.

---

## Installation

Installation steps here.

La ligne horizontale dans le démarque GitHub offre une séparation visuelle nette entre les sections principales sans s'appuyer uniquement sur les titres.

Discord Markdown Ligne horizontale

Discord prend en charge un sous-ensemble limité de démarques dans les messages de discussion, mais les lignes horizontales ne font pas partie des fonctionnalités prises en charge. Si vous essayez de taper --- ou *** dans un message Discord, l'application n'affichera pas de règle horizontale. Au lieu de cela, il peut afficher les caractères sous forme de texte brut ou interpréter les astérisques comme un formatage gras/italique.

Pour contourner l'absence de ligne horizontale de démarque Discord, de nombreux utilisateurs créent des séparateurs visuels à l'aide de caractères répétés ou d'emoji :

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

Il ne s’agit pas d’une véritable démarque, mais elle remplit le même objectif visuel dans les conversations Discord.

Quand utiliser une ligne horizontale dans Markdown

Les lignes horizontales fonctionnent mieux dans des situations spécifiques. Utilisez-les pour séparer un en-tête de document ou un bloc de métadonnées du contenu principal, pour diviser des sections non liées au sein d'un seul document ou pour marquer une transition dans un récit ou un sujet. Ils sont également utiles dans les longs fichiers README dans lesquels plusieurs sections principales bénéficient de fortes limites visuelles.

Évitez d’en abuser. Si chaque section de votre document est séparée par une ligne horizontale, l'effet perd de son impact et le document peut sembler saccadé. Les titres seuls suffisent généralement pour la plupart des besoins structurels, les lignes horizontales étant réservées aux ruptures plus importantes.

Lignes horizontales et Front Matter

Si vous utilisez des générateurs de sites statiques comme Jekyll, Hugo ou Astro, vous remarquerez que --- sert également de délimiteur pour les blocs de présentation en haut des fichiers de démarque :

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

Content starts here.

L'analyseur fait la distinction entre les règles préliminaires et les règles horizontales en fonction de la position. Les triples traits d'union au tout début d'un fichier ouvrent un bloc de premier plan, tandis que les mêmes caractères ailleurs dans le document créent une ligne horizontale. Gardez cela à l'esprit afin de ne pas casser accidentellement votre exposé en ajoutant des lignes --- supplémentaires en haut de votre fichier.

Référence rapide

Voici un résumé de toutes les manières d’ajouter une ligne horizontale en démarque :

• --- (trois tirets) est la syntaxe la plus courante et la plus largement prise en charge.
• *** (trois astérisques) fonctionne de manière identique et évite la création accidentelle de titre.
• ___ (trois traits de soulignement) est entièrement pris en charge mais moins couramment utilisé.
• Laissez toujours une ligne vierge au-dessus de la règle horizontale pour éviter qu'elle ne soit interprétée comme un titre.
• Les trois méthodes fonctionnent dans GitHub markdown.
• Discord ne prend pas en charge nativement les lignes horizontales de démarque.

Réflexions finales

Apprendre à ajouter une ligne horizontale dans le markdown ne prend que quelques instants, mais bien l'utiliser nécessite un peu de jugement. Choisissez un style de syntaxe, restez cohérent dans tous vos documents et n'oubliez pas d'inclure une ligne vide au-dessus de la règle pour éviter les surprises de formatage. Avec ces bases en place, vos documents markdown seront plus propres, plus lisibles et mieux organisés.