Trois intentions différentes
Une ligne vide crée un nouveau paragraphe. Deux espaces en fin de ligne créent un saut explicite en CommonMark. Un simple retour à la ligne peut être rendu comme une espace.
| Besoin | Syntaxe |
|---|---|
| Nouveau paragraphe | Une ligne vide |
| Saut explicite | Deux espaces en fin de ligne |
| Poésie ou adresse | Chaque ligne avec saut explicite |
Créer un nouveau paragraphe
Laissez une ligne complètement vide entre deux blocs de texte. Cette forme exprime une séparation sémantique et reste la plus lisible pour la prose, les README et la documentation.
Forcer un saut dans le même paragraphe
Ajoutez deux espaces à la fin de la ligne avant le retour. Ces espaces étant invisibles, utilisez cette syntaxe seulement lorsque chaque rupture compte, par exemple dans une adresse ou un poème.
Première ligne.
Deuxième ligne.Deux lignes dans le même paragrapheUtiliser la barre oblique inverse
CommonMark accepte aussi une barre oblique inverse placée juste avant le retour à la ligne. Elle rend l’intention plus visible dans la source, mais vérifiez que votre plateforme applique bien cette règle.
Pourquoi le résultat varie
Certaines plateformes activent les retours souples ou acceptent <br>. Testez la source dans la destination finale.
Réserver <br> aux destinations compatibles
La balise HTML peut être pratique, mais elle dépend de l’autorisation du HTML brut. Un moteur sécurisé peut la filtrer ; elle est donc moins portable qu’un paragraphe Markdown ordinaire.
Vérifier les listes, citations et tableaux
Dans une liste ou une citation, l’indentation et les marqueurs modifient la structure. Dans un tableau, un retour dans une cellule n’est généralement pas portable. Contrôlez ces cas dans l’aperçu final.
Éviter les espaces invisibles difficiles à maintenir
Pour la prose, préférez des paragraphes séparés. Réservez les deux espaces aux cas où la rupture visuelle est réellement nécessaire.
Outils associés
Questions fréquentes
Pourquoi la touche Entrée ne suffit-elle pas ?
CommonMark peut fusionner ce retour avec une espace dans le même paragraphe.
Puis-je utiliser <br> ?
Seulement si la destination accepte le HTML brut.
Comment créer un nouveau paragraphe ?
Laissez une ligne vide entre les deux blocs de texte.
Les deux espaces de fin sont-ils visibles ?
Non, ce qui les rend faciles à supprimer par inadvertance lors d’un nettoyage.
La barre oblique inverse fonctionne-t-elle partout ?
Elle appartient à CommonMark, mais testez tout de même le moteur de publication utilisé.
Pourquoi le saut disparaît-il dans un tableau ?
Les retours internes aux cellules ne sont pas représentés de manière portable par les tableaux Markdown courants.