MD ViewerMD Viewer

100 % privé — tout s'exécute dans votre navigateur

Retour à la ligne Markdown

Une pression sur Entrée ne suffit pas — deux créent un paragraphe. Testez le retour à la ligne Markdown en direct et voyez exactement où tombent vos sauts de ligne.

Équipe MD Viewer

Exemples
Source Markdown
Aperçu

First line Second line

Les règles du retour à la ligne Markdown surprennent tout le monde : vous pressez Entrée en fin de ligne et le texte rendu continue simplement dans le même paragraphe. Ce n'est pas un bug. En CommonMark, un newline unique est une coupure douce que le moteur peut joindre au moment de composer le texte. Un vrai retour à la ligne Markdown — celui qui crée un bloc visible — exige soit une ligne vide pour un paragraphe, soit un marqueur de fin de ligne pour une coupure dure.

Le terrain de jeu ci-dessus rend la différence physique. L'exemple Simple retour à la ligne contient deux lignes séparées par un Entrée : regardez l'aperçu les fusionner en un paragraphe fluide. Passez à l'exemple Ligne vide et le même texte se scinde en deux paragraphes espacés. Éditez ce que vous voulez : l'aperçu se met à jour instantanément, et l'intuition du retour à la ligne Markdown remplace la mémoire des règles.

Cette page traite de la question des paragraphes : ce que le retour à la ligne Markdown fait à la structure du document. Si votre objectif est de forcer un saut dans le même paragraphe — adresses, vers, raccourcis clavier — la page saut de ligne Markdown couvre les coupures dures à deux espaces et à antislash. Les deux pages exécutent le même moteur dans votre navigateur, sans envoi ni compte.

Aide-mémoire du retour à la ligne Markdown

Vous tapezCe qui s'affiche
ligne un ligne deuxUn paragraphe — le newline est une coupure douce qui s'efface
ligne un ligne deuxDeux paragraphes — la ligne vide crée un vrai bloc de retour à la ligne Markdown
ligne un ligne deuxUn paragraphe avec coupure dure (deux espaces finaux)
ligne un\ ligne deuxUn paragraphe avec coupure dure (antislash)
un deuxDeux paragraphes — les lignes vides supplémentaires n'ajoutent pas d'espace

Comment ajouter un retour à la ligne Markdown correctement

  1. 1

    Décidez ce que vous voulez vraiment

    Un nouveau paragraphe, ou un saut dans le paragraphe ? Le retour à la ligne Markdown adapté à la prose est le paragraphe ; pour les vers et les adresses, c'est la coupure dure dans un même bloc.

  2. 2

    Pressez Entrée deux fois pour un paragraphe

    Une ligne vide est le retour à la ligne Markdown qui démarre un bloc neuf. Tout ce qui se trouve entre deux lignes vides forme un paragraphe, quel que soit le nombre de newlines simples à l'intérieur.

  3. 3

    Vérifiez dans l'aperçu en direct

    Utilisez les puces d'exemples ci-dessus pour basculer entre newline simple et ligne vide, puis observez le panneau d'aperçu : voir le comportement du retour à la ligne Markdown rendu va plus vite que le lire.

  4. 4

    Évitez le martèlement d'Entrée

    Empiler des lignes vides n'apporte rien — les moteurs les réduisent à un seul écart de paragraphe. Une ligne vide est toute la syntaxe du retour à la ligne Markdown pour un nouveau bloc.

Pourquoi un retour à la ligne Markdown ne coupe pas par défaut

Markdown a été conçu pour du texte reflowable : un même paragraphe doit se réafficher harmonieusement sur un téléphone comme sur un écran large. Si chaque Entrée produisait une coupure visible, un texte collé depuis un terminal ou replié par un éditeur se briserait en fragments. La règle du retour à la ligne Markdown traite donc un newline comme une suggestion que le moteur peut ignorer — le paragraphe, pas la ligne, est l'unité de mise en page.

Certaines plateformes divergent : les commentaires GitHub, les messageries et plusieurs saveurs de wikis rendent les newlines simples comme des coupures dures, pour coller à la façon dont on tape des messages. Cette divergence est précisément pourquoi cette page suit l'interprétation CommonMark standard : votre document reste prévisible quand il migre vers un moteur plus strict. Et quand une coupure dans le paragraphe est vraiment nécessaire partout, la syntaxe explicite de la page saut de ligne Markdown répond au besoin.

Retour à la ligne Markdown : quoi taper, quoi éviter

Les roses sont rouges Les violettes sont bleues

Les roses sont rouges Les violettes sont bleues

Des phrases séparées par un seul newline fusionnent en un paragraphe. Une ligne vide donne à chaque phrase son propre bloc.

Cinq newlines pour espacer

Une ligne vide

Les lignes vides supplémentaires sont réduites. L'écart du retour à la ligne Markdown est fixé par la feuille de style du moteur, pas par votre nombre d'Entrées.

Shift+Entrée en espérant une coupure

Deux espaces finaux ou un antislash

La source Markdown ignore Shift+Entrée. Pour une coupure dure dans un paragraphe, utilisez la syntaxe explicite de la page saut de ligne Markdown.

Les paragraphes sont structurels, pas décoratifs

Considérez le retour à la ligne Markdown comme une décision de structure : une ligne vide signale une nouvelle idée, un newline simple prolonge la même idée. Lecteurs d'écran, outils de plan et export PDF utilisent les frontières de paragraphes — une structure propre en source devient une structure propre partout.

Questions fréquentes

Sources et citations de spécification

“A regular line ending (not in a code span or HTML tag) that is not a hard line break is a soft line break.”
CommonMark Specification 0.31.2
“The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible.”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

Outils Markdown associés