mdBook : indentation : espaces ou tabulations ?

Je recommande d’utiliser des tabulations pour l’indentation et non des espaces, dans mdBook comme ailleurs.

Si toutefois vous utilisez des espaces, voici quelques éléments à prendre en considération pour les listes.

Nota bene : Lorsque vous aurez terminé de lire cette page mdBook, si vous avez tout bien compris, vous utiliserez les tabulations.

Indentation avec des espaces dans les listes

Il faut mettre au moins autant d’espaces que le nombre de caractères à gauche du texte du niveau précédent, espace compris :

• 2 caractères pour « * » (étoile + espace) ;
• 3 caractères pour « 1. » (un + point + espace).

Dans le cas où vous ne respectez pas ce nombre minimum, le compilateur mdBook interprète mal les niveaux.

Par exemple :

* liste de niveau 1
  * liste de niveau 2
 * liste de niveau 2 mal positionnée
    * liste de niveau 3 mal comprise car l'élément précédent est mal positionné.

produit :

• liste de niveau 1
  • liste de niveau 2
• liste de niveau 2 mal positionnée
  • liste de niveau 3 mal interprétée par le compilateur car l’élément précédent est mal positionné.

Bref, c’est bien plus sûr, plus rapide, plus simple et moins coûteux en octets avec des tabulations !

Fin de la blague.