mdBook : Markdown : Codes dans le texte

Le caractère ` est obtenu avec la combinaison de touches AltGr + 7 dans Linux.

Pour insérer du code à l’intérieur d’un paragraphe, nous encadrons le texte du code avec le caractère `.

Exemple :

Ceci est un texte avec un `code`.

affiche :

Ceci est un texte avec un code.

Cas d’un code avec un ` à l’intérieur

Si nous avons besoin d’insérer un code qui, lui-même, comporte un caractère ` à l’intérieur, nous doublons celui-ci : ``.

Exemple :

Ceci est un texte avec un ``code qui comporte un `mot` encadré`` par le caractère `` ` ``.

affiche :

Ceci est un texte avec un code qui comporte un `mot` encadré par le caractère `.

Mettre une espace interprétée comme séparateur

Dans `` ` ``  l’espace sert de séparateur pour permettre au compilateur mdBook de comprendre comment interpréter la série de `.

Si nous les écrivons tous à la suite sans espace, le compilateur voit un seul token (au sens du langage informatique) et la page mdBook produite affiche ceci : `````.

Si nous écrivons `` ` ``, nous indiquons, grâce à l’espace (qui sert ici de séparateur et non en tant que caractère à afficher) au compilateur mdBook qu’il doit « voir » : `` suivi de ` suivi de ``.
Le compilateur mdBook comprend alors ce que nous souhaitons faire et l’interprète correctement pour afficher ` comme souhaité.

C’est une exception à une règle qui consiste, en principe, à ne surtout pas modifier quoique ce soit dans des blocs de codes. Pour la bonne cause, évidemment.