mdBook : Markdown : Les listes

Les listes (non numérotées)

Le caractère Markdown pour identifier une liste est le * placé en début de ligne (et suivi d’au moins une espace).

Note : Le - fonctionne également en langage Markdown et dans mdBook.

L’indentation permet de signaler des sous-niveaux de listes.

Je recommande d’utiliser des tabulations pour réaliser l’indentation.
Voir mdBook : indentation : espaces ou tabulations ?.

Exemple de liste avec des sous-niveaux :

* liste de niveau 1
	* liste de niveau 2
		* liste de niveau 3
			* liste de niveau 4
	* liste de niveau 2
* liste de niveau 1
	* liste de niveau 2

affiche :

• liste de niveau 1
  • liste de niveau 2
    • liste de niveau 3
      • liste de niveau 4
  • liste de niveau 2
• liste de niveau 1
  • liste de niveau 2

Les listes numérotées

Le caractère Markdown pour identifier une liste numérotée est 1. placé en début de ligne (et suivi d’au moins une espace).

L’indentation permet de signaler des sous-niveaux de listes numérotées.

Je recommande d’utiliser des tabulations pour réaliser l’indentation.
Voir mdBook : indentation : espaces ou tabulations ?.

Exemple de liste numérotée avec des sous-niveaux :

1. liste de niveau 1
	1. liste de niveau 2
		1. liste de niveau 3
			1. liste de niveau 4
	1. liste de niveau 2
1. liste de niveau 1
	1. liste de niveau 2

affiche :

1. liste de niveau 1
   1. liste de niveau 2
      1. liste de niveau 3
         1. liste de niveau 4
   2. liste de niveau 2
2. liste de niveau 1
   1. liste de niveau 2

Listes mixtes numérotées ou non

Il est possible de mixer des listes numérotées et des listes (non numérotées).

Exemple :

1. liste de niveau 1
	1. liste de niveau 2
		1. liste de niveau 3
			1. liste de niveau 4
			* niveau 1 de la liste non numérotée 1
			* niveau 1 de la liste non numérotée 1
				* niveau 2 de la liste non numérotée 1
	1. liste de niveau 2
	* niveau 1 de la liste non numérotée 2
		* niveau 2 de la liste non numérotée 2
			* niveau 3 de la liste non numérotée 2
	* niveau 1 de la liste non numérotée 2
1. liste de niveau 1
	1. liste de niveau 2

affiche :

1. liste de niveau 1
   1. liste de niveau 2
      1. liste de niveau 3
         1. liste de niveau 4
         • niveau 1 de la liste non numérotée 1
         • niveau 1 de la liste non numérotée 1
           • niveau 2 de la liste non numérotée 1
   2. liste de niveau 2
   • niveau 1 de la liste non numérotée 2
     • niveau 2 de la liste non numérotée 2
       • niveau 3 de la liste non numérotée 2
   • niveau 1 de la liste non numérotée 2
2. liste de niveau 1
   1. liste de niveau 2

Respect de la logique d’indentation

L’interpréteur ne sait pas gérer des décalages de plus de 1 niveau en descendant dans les sous-niveaux.

C’est tout à fait normal si on reprend la logique de la structure des niveaux et sous-niveaux de listes : Un élément de liste de niveau N+1 est nécessairement consécutif à un élément de liste de niveau N.

Si nous faisons une erreur, le compilateur mdBook n’interprète pas l’élément de liste de niveau inférieur décalé et l’ajoute à la suite de l’élément de liste en cours.

Par exemple :

1. liste de niveau 1
	1. liste de niveau 2
		1. liste de niveau 3
			1. liste de niveau 4
	1. liste de niveau 2
1. liste de niveau 1
			1. liste de niveau 4

affiche :

1. liste de niveau 1
   1. liste de niveau 2
      1. liste de niveau 3
         1. liste de niveau 4
   2. liste de niveau 2
2. liste de niveau 1 1. liste de niveau 4

Dans l’exemple ci-dessus, un élément de liste de niveau 4 succède directement à un élément de liste de niveau 1, ce qui n’est pas possible. Le 1. est alors traité comme un élément du texte 1. liste de niveau 4 et non comme un marqueur de liste numérotée. La présence de plusieurs tabulations est simplement ignorée.