Ce bloc-notes mdBook vous est proposé avec passion par Marc JESTIN — Happy Numeric.
À votre service pour vous accompagner dans vos projets numériques.
Contact : https://happynumeric.fr/me-contacter.
mdBook : Markdown : Ligne horizontale
Pour insérer une ligne horizontale, il convient d'ajouter
---
au début d'une ligne à l'endroit souhaité.
La Ligne horizontale occupe tout l'espace de la zone de texte.
Par exemple :
Ceci est mon texte
---
affiche
Ceci est mon texte
Avec des listes indentées :
Code markdown :
* Liste de niveau 1
* Liste de niveau 2
---
Résultat affiché :
- Liste de niveau 1
- Liste de niveau 2
Le trait horizontal commence bien à gauche de la zone de texte.
Respecter le saut de ligne
Attention de bien séparer l'indication de ligne horizontale (---
) de la ligne de texte qui la précède avec une ligne vide.
Le fait d'oublier le saut de ligne peut avoir des conséquences liées au langage Markdown.
Par exemple :
Ceci est mon texte
---
affiche :
Ceci est mon texte
car le soulignement est interprété comme étant un indication de titre par le compilateur mdBook.
En effet, le fait d'insérer un (ou plusieurs) trait(s) -
directement dans la ligne sous un texte est interprété comme une indication de titre de niveau 2 dans le langage Markdown.
Tout n'est pas possible
Certaines présentations ne produisent pas ce qu'une analyse humaine peut imaginer lorsque nous travaillons en langage Markdown.
Par exemple :
---
* liste 1
---
* liste 2
---
affiche :
- liste 1
* liste 2
Le *
n'est pas interprété comme une liste pour liste 2, non pas à cause des lignes horizontales, mais du fait de l'isolement de la ligne.
Lorsqu'il analyse cette syntaxe, le compilateur mdBook voit une ligne isolée commençant par une tabulation, ce qui signifie pour lui qu'il s'agit d'un bloc de code.
En effet, la tabulation est une alternative aux ```
sur les lignes avant et après le contenu pour définir un bloc de code en langage Markdown.
Cas particulier de SUMMARY.md
Le compilateur mdBook crée un affichage de cette ligne en fonction de la ligne qui la précède dans SUMMARY.md
Comme nous pouvons le voir ici :
La ligne démarre son côté gauche à hauteur du paragraphe qui la précède.
Le code correspondant dans le fichier source SUMMARY.md est :
Je pense que nous pouvons considérer ce décalage lié à l'indentation comme un bogue.
Trois traits ou plus
Le compilateur mdBook crée une ligne horizontale à partir de trois traits -
.
Il interprète tout nombre de traits -
supérieur ou égal à trois comme une seule et même ligne.
De même s'il y a un ou plusieurs espaces et un ou plusieurs ensembles continus de traits : le compilateur mdBook ne crée qu'une seule ligne dans le site Web mdBook produit.
Ce bloc-notes mdBook vous est proposé par Marc JESTIN — Happy Numeric. |
Formation, rédaction de documentations techniques ou organisationnelles, mise en place de solutions documentaires internes et externes, assistance à maîtrise d'ouvrage, etc. |
Contact : https://happynumeric.fr/me-contacter |
N'hésitez pas à me faire votre feedback, me signaler des erreurs ou des compléments que vous souhaiteriez que j'ajoute à ce bloc-notes mdBook.
Cliquez ici pour me contacter
À propos de cette page
Création : 18 mars 2023
Dernière mise à jour : 23 mars 2023 21:30