MD ViewerMD Viewer

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

Liste numérotée Markdown

Construisez une liste numérotée Markdown élément par élément — ajoutez, supprimez, réordonnez — et regardez la numérotation se rendre en direct. Marqueurs, imbrication et indentation inclus.

Équipe MD Viewer

Exemples
1.
2.
3.
1. First
2. Second
3. Third
Aperçu
  1. First
  2. Second
  3. Third

Une liste numérotée Markdown est une liste ordonnée : des lignes commençant par 1., 2., 3. qui se rendent en vraie séquence numérotée. Le terrain de jeu ci-dessus est un constructeur de liste en direct — chaque élément est un champ de saisie, les boutons Ajouter et Supprimer font grandir et rétrécir la liste numérotée Markdown, et l'aperçu renumérote tout au fil de l'eau. En dessous, la source générée se met à jour en temps réel : vous voyez toujours le balisage exact derrière la liste.

La liste numérotée Markdown possède un super-pouvoir célèbre : la numérotation paresseuse. Commencez chaque ligne par 1. et la plupart des moteurs sortent quand même 1, 2, 3 — les chiffres réels de votre source comptent bien moins que le marqueur, le point et l'indentation. C'est pourquoi réordonner les éléments d'une liste numérotée Markdown ne vous laisse jamais renuméroter un document à la main, et pourquoi le constructeur ci-dessus peut insérer un élément au milieu sans toucher aux autres.

Cette page couvre l'anatomie complète : les formes de marqueurs 1. et 1), la façon dont la profondeur d'indentation pilote l'imbrication, les lignes vides qui séparent listes serrées et lâches, et les erreurs — indents incohérents, marqueurs mêlés — qui cassent silencieusement la numérotation. Chaque affirmation se teste dans le terrain de jeu, et tout s'exécute localement dans votre navigateur.

Référence de la syntaxe de liste numérotée Markdown

Vous tapezCe qui se rend
1. Premier 2. SecondUne liste numérotée Markdown simple, numérotée 1 et 2
1. Pareil 1. PareilToujours 1, 2, 3 — les moteurs renumérotent pour vous
1) Parenthèse 2) ParenthèseLe marqueur parenthèse construit aussi une liste ordonnée
1. Élément 1. SousUne liste numérotée Markdown imbriquée dans le premier élément
1. A 2. BUne liste lâche — les lignes vides ajoutent l'écart de paragraphe

Comment écrire une liste numérotée Markdown

  1. 1

    Commencez chaque ligne par un numéro et un marqueur

    Tapez 1. suivi d'une espace, puis le texte de l'élément. Répétez sur la page — une liste numérotée Markdown accepte 1. à 999999. et normalise le reste.

  2. 2

    Indentez de trois espaces pour imbriquer

    Alignez les éléments imbriqués sous le texte du parent — trois ou quatre espaces pour les marqueurs 1. La liste numérotée Markdown imbriquée devient une sous-liste avec sa propre numérotation.

  3. 3

    Séparez du texte environnant

    Gardez une ligne vide au-dessus de la liste pour qu'elle ne soit pas avalée comme continuation de paragraphe. Dans la liste, les lignes vides entre éléments font passer la liste numérotée Markdown de serrée à lâche.

  4. 4

    Construisez et copiez

    Utilisez l'éditeur d'éléments ci-dessus pour ajouter et retirer des entrées, puis Copier le Markdown pour emporter la source générée de votre liste numérotée Markdown.

Règles de numérotation et le motif du 1. paresseux

La liste numérotée Markdown hérite d'une idée de la spec originale : le premier numéro fixe la valeur de départ, et le moteur compte les éléments lui-même. Une liste dont toutes les lignes commencent par 1. se rend 1, 2, 3, 4 — ce qui ressemble à un bug jusqu'à ce que vous l'utilisiez. Insérer un élément au milieu avec le motif tous-1 ne demande aucune renumérotation ; supprimer un élément ne laisse aucun trou. Beaucoup de gros projets de documentation imposent ce motif dans leurs guides de style pour cette raison exacte.

Le contrat a une clause à connaître : un saut réel dans les chiffres de la source n'est honoré qu'au départ. Commencer une liste numérotée Markdown à 5. démarre le compte rendu à 5 ; commencer plus loin des lignes à 42 ne change rien. Quand des numéros précis visibles comptent — clauses juridiques, sous-articles de contrat — vérifiez la sortie rendue plutôt que de croire les chiffres sources. L'aperçu du terrain de jeu montre la numérotation rendue de toute liste construite : c'est l'habitude que cette page cherche à enseigner.

Une dernière habitude à adopter : gardez chaque élément d'une liste numérotée Markdown structurellement parallèle — une phrase, même voix, même capitalisation. Les éléments parallèles se parcourent plus vite, et quand la liste finit par devoir se convertir en PDF ou se rendre en diapositive, les éléments uniformes survivent au changement de format sans reprise. Le constructeur ci-dessus garde le rythme visible pendant que vous tapez.

Erreurs de liste numérotée Markdown

1. Un 2. Deux 1. Trois

1. Un 2. Deux 3. Trois

Des numéros mélangés se rendent souvent 1-2-3 quand même, mais les relecteurs lisent la source. Alignez les numéros de la liste numérotée Markdown sur l'intention pour des diffs propres.

1. Parent 1. Enfant (2 espaces)

1. Parent 1. Enfant (3 espaces)

Deux espaces d'indentation ne suffisent pas sous un marqueur 1. — l'enfant fusionne dans la ligne parent. Une liste numérotée Markdown imbriquée exige l'alignement sous le texte.

1. Premier - Second

1. Premier 2. Second

Changer de type de marqueur en pleine liste en démarre une nouvelle — la séquence repart à zéro. Un seul style de marqueur par liste numérotée Markdown.

Les listes ordonnées s'exportent fidèlement

Une liste numérotée Markdown construite ici se convertit proprement sur la page convertir Markdown en PDF : vraie numérotation, indentation correcte des niveaux imbriqués, et sauts de page qui ne séparent jamais un élément de son numéro.

Questions fréquentes

Sources et citations de spécification

“An ordered list marker is a sequence of 1-9 arabic digits (0-9), followed by either a . character or a ) character.”
CommonMark Specification 0.31.2
“Markdown is intended to be as easy-to-read and easy-to-write as is feasible.”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

Outils Markdown associés