Sauts de ligne Markdown : nouvelles lignes, paragraphes et cellules

Pour commencer une nouvelle ligne dans un paragraphe Markdown, placez une barre oblique inverse à la fin de la première ligne, puis appuyez sur Entrée. Pour commencer un autre paragraphe, laissez une ligne vide. Ces deux méthodes produisent des structures différentes dans le document, ce qui compte lorsque vous exportez ensuite un README, une adresse ou un rapport vers Word.

Équipe de documentation\
42, rue Exemple\
Portland, Oregon

L'adresse reste dans un seul paragraphe affiché sur trois lignes. Collez-la dans l'aperçu Markdown pour la comparer aux exemples ci-dessous.

Choisir le type de saut nécessaire

Un saut de ligne ne crée pas de saut de page. Si la section suivante doit commencer sur une nouvelle feuille dans le document exporté, consultez le guide des sauts de page Markdown.

Pourquoi Entrée peut apparaître comme une espace

Essayez cette source :

Le brouillon est prêt.
La personne chargée de la relecture peut l'ouvrir aujourd'hui.

Dans l'aperçu de ce site, les deux phrases appartiennent au même paragraphe et s'enchaînent. Le retour à la ligne reste utile dans le fichier source, mais n'oblige pas le navigateur à commencer une nouvelle ligne affichée. Le navigateur peut toujours ajuster les lignes à la largeur disponible.

Insérez maintenant une ligne vide :

Le brouillon est prêt.

La personne chargée de la relecture peut l'ouvrir aujourd'hui.

L'aperçu produit deux paragraphes. Utilisez cette version lorsque la deuxième phrase introduit une autre idée. Ajouter plusieurs lignes vides n'est pas un moyen fiable de demander davantage d'espace vertical ; le style des paragraphes dépend du moteur de rendu ou du modèle de document.

Barre oblique inverse ou deux espaces finales

CommonMark définit aussi bien deux espaces avant un retour à la ligne qu'une barre oblique inverse avant ce retour comme la syntaxe d'un saut de ligne forcé dans un paragraphe. Les exemples de sauts de ligne forcés CommonMark documentent les deux formes.

La version avec une barre oblique inverse est visible lors de la relecture d'un fichier :

Préparé par l'équipe de documentation\
Relu par la personne responsable de la version

L'autre possibilité consiste à saisir exactement deux espaces après documentation, puis à appuyer sur Entrée. Ces espaces sont invisibles dans de nombreux éditeurs et peuvent être supprimées par le nettoyage automatique des espaces finales. Si un saut disparaît après l'enregistrement, vérifiez les paramètres des espaces ou utilisez la barre oblique inverse.

Ne saisissez pas les deux caractères \n dans du texte courant en espérant obtenir un saut. C'est une convention des chaînes de caractères en programmation, pas un retour à la ligne Markdown. Évitez également de placer une barre oblique inverse tout à la fin d'un paragraphe : un saut forcé nécessite une autre ligne de contenu du même paragraphe après lui.

Les commentaires GitHub et les fichiers README se comportent différemment

La documentation GitHub sur les sauts de ligne distingue les fichiers .md d'un dépôt des tickets, demandes de fusion et discussions. Des retours ordinaires peuvent s'afficher comme des sauts dans ces espaces de conversation, tandis qu'un README nécessite une syntaxe explicite de saut forcé.

Cette différence explique pourquoi du texte copié depuis un ticket peut apparaître différemment dans un README. Vérifiez le fichier de destination au lieu de supposer que toutes les interfaces d'un même site appliquent des règles de mise en forme identiques.

Garder la suite dans un élément de liste

Indentez la suite pour l'aligner sur le début du texte de l'élément :

- Notes de version\
  Inclure les instructions de migration.
- Guide d'installation

Ici, le premier élément s'affiche sur deux lignes. Le deuxième reste distinct. Pour créer un paragraphe séparé dans le premier élément, utilisez une ligne vide et conservez l'indentation de la suite :

- Notes de version

  Inclure les instructions de migration et les problèmes connus.
- Guide d'installation

Le guide de l'indentation présente les listes numérotées, les puces imbriquées et le code à l'intérieur d'un élément.

Ajouter une nouvelle ligne dans une cellule de tableau Markdown

Une ligne de tableau GFM doit tenir sur une seule ligne du fichier source. Appuyer sur Entrée dans son contenu peut scinder la ligne du tableau. Dans les moteurs de rendu qui acceptent les sauts de ligne HTML, utilisez ce modèle :

| Document | Responsables |
| --- | --- |
| Notes de version | Rédacteur<br>Relecteur |

L'aperçu de ce site prend en charge cet exemple. Une destination qui supprime le HTML peut retirer le saut ou afficher la balise ; vérifiez donc cette plateforme avant d'utiliser cette méthode dans tout le document. Une liste en dehors du tableau est souvent plus facile à maintenir lorsqu'une cellule nécessite plusieurs paragraphes.

Utilisez le générateur de tableaux Markdown pour les données tabulaires et le guide de syntaxe des tableaux pour l'alignement et les barres verticales échappées.

Vérifier le document exporté

Avant d'utiliser le convertisseur Markdown vers Word, testez un court extrait contenant un retour à la ligne ordinaire, un saut forcé explicite et une ligne vide. L'aperçu doit montrer respectivement un paragraphe continu, un saut de ligne forcé et deux paragraphes distincts.

Ouvrez le DOCX téléchargé et examinez l'adresse, les listes et le tableau. La largeur de page et les styles de paragraphe de Word peuvent modifier le retour automatique à la ligne même lorsque les sauts sous-jacents sont corrects. Corrigez d'abord la structure Markdown ; ajustez la typographie finale dans Word lorsqu'un modèle de document particulier l'exige.