mdBook : Markdown : mise en forme des caractères

La mise en forme est gérée par l’encadrement des zones souhaitées par un élément de code composé d’un ou plusieurs caractères dans la syntaxe du langage Markdown.

Mettre en italique

Il suffit de mettre un astérisque * avant et après un texte pour qu’il soit affiché en italiques.

Par exemple :

« Le mot *italique* est écrit en *italiques*. »

affiche :

« Le mot italique est écrit en italiques. »

Mettre en gras

Les deux astérisques ** qui l’encadrent (ou les encadrent) indiquent un (ou plusieurs) caractère(s) en gras.

Par exemple :

« Le mot **gras** est écrit en **gras**. »

affiche :

« Le mot gras est écrit en gras. »

Mettre en gras italique

Pour mettre un texte en gras italique, nous l’encadrons de trois astérisques ***.

Par exemple :

« Les mots ***gras et italique*** sont écrits en ***gras italiques***. »

affiche :

« Les mots gras et italique sont écrits en gras italiques. »

Barrer

Le double tilde ~~ encadre un texte barré.

Par exemple :

« Le mot ~~barré~~ est ~~barré~~. »

affiche :

« Le mot barré est barré. »

Souligner du texte

Markdown ne permet pas de souligner du texte.

En Markdown, le soulignement juste en dessous du texte dans le fichier source produit un titre :

• un ou plusieurs = pour un titre de niveau 1 ;
• un ou plusieurs - pour un titre de niveau 2.

Cette syntaxe n’est pas instruite dans la documentation officielle de mdBook.

En effet, dans les fichiers.md (hors sommaire mdBook) nous utilisons :

• # en début de ligne suivi d’une espace pour un écrire un titre de niveau 1 ;
• ## en début de ligne suivi d’une espace pour écrire un titre de niveau 2 ;
• et ainsi de suite jusqu’au niveau 6 inclus.

Des combinaisons sont possibles

Des combinaisons sont possibles.

Par exemple, il est possible de mettre un code en gras comme lorsque j’écris fichiers.md.

Pour ce faire, j’ai écrit ceci dans le fichier source de cette page mdBook :

**`fichiers.md`**

Dans les combinaisons, la hiérarchie et la logique s’appliquent

Les caractères écrits le plus à l’extérieur sont interprétés en premier.

Cette écriture :

`**fichiers.md**`

produit :

**fichiers.md**

et c’est logique : comme j’ai indiqué au compilateur mdBook qu’il doit afficher un texte (ici **fichier.md**) en tant que code, le compilateur mdBook ne cherche pas à interpréter les ** à l’intérieur du code en question, il les affiche en tant que parties du code, comme demandé.

Attention, il peut exister des exceptions à la logique : c’est le cas avec la consigne include de mdBook lorsqu’elle est écrite dans un bloc de code.
J’aborde ce point dans la page appropriée de ce livre.