mdBook : particularités de la syntaxe

Sous-chapitres : limitation à 6 niveaux

Lorsque nous essayons :

## Titre de niveau 2
### Titre de niveau 3
#### Titre de niveau 4
##### Titre de niveau 5
###### Titre de niveau 6
####### Titre de niveau 7
######## Titre de niveau 8

les niveaux 7 et 8 ne sont pas interprétés par le compilateur comme nous pouvons le voir :

Titre de niveau 2

Titre de niveau 3

Titre de niveau 4

Titre de niveau 5

Titre de niveau 6

####### Titre de niveau 7 ######## Titre de niveau 8

Nous ne disposons donc que de 6 niveaux dans nos pages chapitres (5 en réalité, le niveau 1 étant réservé aux titres de chapitres et ne devant apparaître en principe qu’une fois tout en haut d’une page).

Ceci est conforme à la spécification HTML.

Choix du caractère Markdown pour les listes non numérotées

Le - suivi d’une espace en début de ligne est interprété de la même manière que le *.

Je recommande de n’utiliser que le « * » qui est le caractère indiqué dans la documentation officielle mdBook (lists).

Voici par exemple un code Markdown :

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

qui affiche :

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