mdBook : Markdown : choses à savoir

Saut de ligne

Dans le langage Markdown, le fait d’écrire deux lignes l’une à la suite de l’autre est interprété comme une continuité.

Le code :

Ligne 1.
Ce que je crois être la ligne 2.

affiche :

Ligne 1. Ce que je crois être la ligne 2.

Le compilateur mdBook ajoute une espace entre les deux blocs de texte et les écrit l’un à la suite de l’autre sur la même ligne.

Pour écrire un saut de ligne en langage Markdown, nous ajoutons deux espaces ( ) à la fin de la ligne et nous passons effectivement à la ligne.

Ligne 1.  
Ligne 2.

où j’ai bien mis deux espaces à la fin de la ligne 1, que vous pouvez voir en sélectionnant les deux lignes, affiche :

Ligne 1.
Ligne 2.

Espaces multiples

Le compilateur mdBook « arrange » parfois notre texte : si nous écrivons plus d’une espace entre plusieurs mots, il va corriger.

Par exemple, si j’écris :

Ceci            est           un           texte.

Le résultat affiché sera :

Ceci est un texte.

Soulignement et titres

Si j’écris :

Texte
=====

en croyant avoir souligné le texte, le compilateur mdBook crée un chapitre de page mdBook de niveau 1 car c’est la syntaxe Markdown pour le faire.

Texte

Le soulignement de texte n’existe pas en langage Markdown sauf pour l’affichage des liens web en fonction des paramètres des feuilles de style (c’est en réalité en HTML / CSS que ce soulignement intervient, pas dans Markdown à proprement parler).

Par défaut, mdBook n’affiche pas de soulignement pour les liens web, il sont simplement affichés avec une couleur particulière.
Lorsque nous passons la souris sur un lien Web, le soulignement apparaît.
C’est un paramétrage dans les feuilles de style choisi par mdBook.

Syntaxe et séparateurs

Il convient de respecter strictement la syntaxe du langage Markdown.

Les codes qui encadrent un texte doivent être collés au texte en question.

L’espace peut être interprété comme un séparateur et non comme un caractère espace. Ce point est abordé à un endroit que je vous laisse découvrir le moment venu dans ce livre.

La ligne vide est un séparateur dans le langage Markdown. Il ne faut pas, par exemple, insérer de ligne vide dans un même tableau.

Soyons bien attentifs à la syntaxe proposée dans les exemples de ce livre et… Restons vigilant·e·s !