100 % privé — tout s'exécute dans votre navigateur
Indentation Markdown
Les mêmes espaces signifient trois choses différentes en Markdown. Basculez entre listes imbriquées, code indenté et continuation de paragraphe — chaque cas d'indentation Markdown se rend en direct.
Équipe MD Viewer
- Fruit
- Apple
- Green apple
- Banana
- Apple
- Bread
Le comportement de l'indentation Markdown est contextuel : les mêmes espaces de tête peuvent continuer un paragraphe, imbriquer un élément de liste ou transformer le texte en bloc de code — selon ce qui précède. C'est le piège. On indente pour aligner visuellement et le rendu change : une liste imbriquée apparaît, un paragraphe rejoint un bloc de code, ou l'indent disparaît sans bruit. Le terrain de jeu ci-dessus permet de basculer entre les trois cas d'indentation Markdown d'un clic et de voir exactement ce qui change.
Trois règles à intégrer : deux ou trois espaces (alignés sous un marqueur de liste) imbriquent du contenu de liste ; quatre espaces en début de nouveau bloc créent un bloc de code indenté ; et les espaces de tête d'un paragraphe normal sont simplement ignorés — jusqu'à trois — parce qu'il n'existe pas d'indentation de paragraphe en Markdown. Entre les deux se trouve le cas de continuation, où une ligne indentée après un élément de liste appartient à cet élément plutôt qu'au document.
Cette page rend chaque cas avec le même moteur que le lecteur, l'éditeur et l'export PDF du site : ce que vous apprenez ici vaut partout. Essayez les exemples, éditez les sources, et servez-vous des explications ci-dessous pour prédire ce que fera n'importe quelle indentation Markdown avant de la valider dans un README.
Indentation Markdown : ce que deviennent les espaces
| Vous tapez | Ce que fait l'indent |
|---|---|
| - élément - enfant | 2 espaces imbriquent un élément sous son parent |
| 1. élément 1. enfant | 3 espaces s'alignent sous le texte pour imbriquer |
| code ici | 4 espaces en début de bloc créent un bloc de code indenté |
| Paragraphe suite | Jusqu'à 3 espaces de tête sont retirés — pas une indentation |
| - élément suite | L'indent aligné continue le paragraphe de l'élément |
Utiliser l'indentation Markdown délibérément
- 1
Imbriquer des listes : alignez sous le texte
Une indentation Markdown imbrique quand elle s'aligne sous le premier caractère de l'élément parent — deux espaces pour les marqueurs -, trois pour les 1. Testez l'exemple Liste imbriquée ci-dessus jusqu'à ce que l'alignement devienne un réflexe.
- 2
Blocs de code : quatre espaces, ligne vide d'abord
Quatre espaces de tête après une ligne vide basculent Markdown en mode code — l'indentation Markdown préserve le texte monospace tel quel. L'exemple Code indenté montre le même contenu avec et sans bascule.
- 3
Paragraphes : n'indentez rien
Les espaces de tête d'un paragraphe (trois ou moins) sont écartés. Il n'y a pas d'indentation de paragraphe en Markdown — la structure vient des lignes vides, pas de l'alignement.
- 4
Continuation : gardez le rythme de l'élément
Les longs éléments de liste s'enveloppent mieux quand les lignes de suite portent la même indentation Markdown que le texte de l'élément. Elles rejoignent l'élément au rendu au lieu de dériver vers un bloc de code ou un nouveau paragraphe.
Pourquoi l'indentation Markdown est contextuelle (et comment s'en souvenir)
Markdown analyse les documents en blocs, et chaque type de bloc porte son propre contrat d'indentation. Un bloc de liste invite l'indentation Markdown alignée pour l'imbrication et la continuation ; un paragraphe la tolère et l'écarte ; un bloc neuf commencé à quatre espaces est présumé code préformaté, convention héritée du citation d'e-mails des années 1990. Le moteur ne demande jamais ce que vous vouliez dire — il applique le contrat du bloc où vous êtes.
L'aide-mémoire pratique est compter-jusqu'à-quatre. Un à trois espaces après un marqueur de liste : imbrication ou continuation. Quatre espaces en terrain libre : code. Quatre espaces directement sous un élément de liste : code imbriqué dans l'élément — ce qui surprend le plus, et que l'exemple Code indenté démontre sans danger. Dans le doute, préférez les blocs de code clôturés par des backticks : les clôtures sont sans ambiguïté, survivent au copier-coller et déclarent un langage pour la coloration.
Une fois l'indentation Markdown acquise, l'architecture des listes cesse d'être une devinette. L'imbrication profonde alterne en pratique deux et quatre espaces par niveau ; la page liste numérotée Markdown ajoute les règles de numérotation par-dessus les mêmes règles d'alignement. Les deux pages partagent le moteur en direct de ce site : le comportement vérifié ici est un comportement de confiance là-bas.
Erreurs d'indentation Markdown
1. Parent 1. Enfant (2 espaces)
1. Parent 1. Enfant (3 espaces)
Deux espaces ne dégagent pas le marqueur 1. de trois caractères : l'enfant fusionne dans la ligne parent. L'indentation Markdown doit s'aligner sous le texte.
Paragraphe ligne indentée
Paragraphe code clôturé ou indenté
Quatre espaces juste après un paragraphe le continuent en texte simple — mais les mêmes quatre espaces après une ligne vide deviennent un bloc de code. La ligne vide est l'interrupteur.
Espaces de tête sur un paragraphe
Aucun espace de tête
L'indentation de paragraphe n'existe pas : jusqu'à trois espaces de tête sont retirés au rendu. Utilisez la structure en blocs, pas l'alignement, pour organiser la prose.
L'indentation survit au PDF
Les listes imbriquées gardent leurs niveaux d'indentation et le code indenté garde son bloc monospace à travers convertir Markdown en PDF — l'export parcourt la même structure que l'aperçu, donc une indentation Markdown vérifiée ici s'imprime pareil.
Questions fréquentes
Sources et citations de spécification
“An indented code block is composed of one or more indented chunks separated by blank lines.”
“The contents of the code block are the literal contents of the lines, including trailing line endings, minus these four spaces of indentation.”