DotMDComment faire un saut de ligne en Markdown :deux espaces, une barre oblique inverse ou une balise br.
Vous appuyez sur Entrée dans un fichier Markdown, et les deux lignes s’affichent comme une seule. C’est voulu. Voici pourquoi, et les trois façons de forcer un saut de ligne.
macOS 14 ou ultérieur. La lecture est gratuite ; l’édition et les relectures se paient en une fois.
Réponse rapide
En Markdown, un simple retour à la ligne est traité comme une espace : les lignes se suivent donc sur la même ligne. Pour couper la ligne, terminez-la par deux espaces ou une barre oblique inverse, ou mettez une balise HTML <br> à la fin. Pour commencer un nouveau paragraphe, laissez une ligne vide.
First line\
Second line, after a backslash
Next paragraph, after a blank line·
Pourquoi Markdown ignore votre retour à la ligne
Markdown rejoint les lignes d’un paragraphe. Si vous écrivez
Roses are red
Violets are bluele lecteur voit un seul paragraphe, Roses are red Violets are blue. Le retour à la ligne du source est un saut mou : un endroit où vous avez replié le texte, pas un endroit où le lecteur doit voir une coupure. Il vous permet de replier les longues lignes dans votre éditeur sans changer l’aspect de la page.
Une ligne vide, c’est autre chose. Elle termine le paragraphe et en commence un nouveau, avec de l’espace entre les deux. Le plus souvent, c’est la coupure qu’il vous faut.
Trois façons de forcer un saut de ligne
Un saut de ligne forcé, ou saut dur, garde le texte dans le même paragraphe et commence la ligne suivante.
-
Deux espaces à la fin de la ligne
Tapez au moins deux espaces avant d’appuyer sur Entrée. Cela marche partout, mais on ne voit pas les espaces, et certains éditeurs ou réglages de Git les suppriment.
-
Une barre oblique inverse à la fin de la ligne
Mettez
\comme tout dernier caractère, sans espace après. Elle est visible et résiste à la suppression des espaces. Elle fait partie de CommonMark et de GitHub Flavored Markdown, même si quelques applications plus anciennes ne la connaissent pas. -
Une balise HTML br
Terminez la ligne par
<br>(ou<br/>). Cela marche dans presque toutes les applications qui acceptent le HTML en ligne. C’est aussi le seul moyen de couper une ligne dans une cellule de tableau.
Two spaces after this line
comes out on a new line.
A backslash ends this one\
and breaks it too.
A tag also works.<br>
Third line.Les trois donnent le même résultat :
Two spaces after this line
comes out on a new line.
Laquelle choisir ?
- Un nouveau paragraphe (ligne vide) pour toute idée distincte. C’est le choix le plus portable.
- Une barre oblique inverse quand il faut une coupure au milieu d’un paragraphe, comme une adresse ou un poème, et que l’application suit CommonMark.
- Une balise br dans une cellule de tableau, ou quand vous n’êtes pas sûr que l’application gère les deux autres.
- Deux espaces seulement si vous êtes certain que rien ne les supprimera.
Les sauts ne fonctionnent pas dans un extrait de code, et un saut tout à la fin d’un paragraphe ne fait rien. Si vous voulez de l’espace vide, utilisez une ligne vide ou un titre, pas un tas de balises <br>.
Exemples : une adresse, un poème, un élément de liste
Un saut dur convient à un texte où la ligne elle-même compte, comme une adresse postale :
Jane Smith221B Baker StreetLondonJane Smith
221B Baker Street
London
Dans un élément de liste, terminez la ligne par le saut et indentez la ligne suivante pour l’aligner sur le texte de l’élément :
- Pack the bags and lock the door
- Leave at eightSi chaque ligne d’un long texte demande un saut, c’est sans doute une liste ou un bloc de code, et Markdown a une syntaxe pour les deux.
Quand le saut de ligne ne marche toujours pas
- Une seule espace en fin de ligne. Il en faut deux ou plus.
- Une espace après la barre oblique inverse. La barre oblique inverse doit être le dernier caractère de la ligne.
- L’éditeur supprime les espaces de fin de ligne à l’enregistrement. Passez à une barre oblique inverse ou à une balise br.
- Le même texte est différent à deux endroits. Certaines applications, comme les zones de saisie des issues et commentaires GitHub, conservent les simples retours à la ligne comme des sauts, alors qu’un fichier Markdown sur GitHub ne le fait pas. Un saut forcé s’affiche pareil dans les deux.
- Du texte dans un élément de liste ou une citation. Gardez le saut en fin de ligne, puis indentez la ligne suivante pour l’aligner sur l’élément.
Le plus rapide est d’ouvrir le fichier dans un lecteur. DotMD suit ces règles : un simple retour à la ligne joint les lignes, et deux espaces, une barre oblique inverse ou un <br> coupent la ligne. La lecture est gratuite, et dans DotMD Editor l’aperçu en direct montre le résultat pendant que vous tapez.
Questions sur les sauts de ligne en Markdown
Comment ajouter une nouvelle ligne en Markdown ?
Terminez la ligne par deux espaces, une barre oblique inverse ou une balise <br> pour couper dans un paragraphe. Laissez une ligne vide pour commencer un nouveau paragraphe.
Pourquoi ma nouvelle ligne est-elle ignorée en Markdown ?
Markdown traite un simple retour à la ligne comme une espace, si bien que les lignes se joignent en un seul paragraphe. Utilisez une ligne vide, deux espaces en fin de ligne, une barre oblique inverse ou <br> pour obtenir une coupure visible.
Deux espaces marchent-ils toujours pour un saut de ligne ?
Dans CommonMark et GitHub Flavored Markdown, oui. Mais les éditeurs et les outils Git suppriment souvent les espaces de fin de ligne, ce qui fait disparaître le saut sans prévenir. Une barre oblique inverse ou <br> est plus sûr.
Comment faire un saut de ligne dans un tableau Markdown ?
Utilisez <br> dans la cellule. Deux espaces et une barre oblique inverse n’y marchent pas, car une rangée de tableau est une seule ligne de texte.