Ce bloc-notes mdBook vous est proposé avec passion par Marc JESTIN — Happy Numeric.
À votre service pour vous accompagner dans vos projets numériques.
Contact : https://happynumeric.fr/me-contacter.

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.

Note : Le - fonctionne également en langage Markdown mais il n'est pas recommandé de l'utiliser.

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.

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éments 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 ». La présence de plusieurs tabulations est simplement ignorée.

N'hésitez pas à me faire votre feedback, me signaler des erreurs ou des compléments que vous souhaiteriez que j'ajoute à ce bloc-notes mdBook.
Cliquez ici pour me contacter

À propose de cette page

Création : 17 mars 2023

Dernière mise à jour : 20 mars 2023 21:39