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 : les tableaux
La création des tableaux en langage Markdown est simple.
Les caractères |
encadrent les contenus des colonnes de tableau.
Le fait d'insérer une ligne de type |-|-|-|
en dessous de la première ligne de tableau permet d'indiquer au compilateur mdBook qu'il s'agit d'un tableau.
La largeur des colonnes de tableau est ajustée automatiquement aux contenus en appliquant des règles de proportionnalité en cas d'atteinte des limites de largeur.
Par exemple :
|Colonne 1|Colonne 2|Colonne 3|
|-|-|-|
|Contenu 1|Contenu 2|Contenu long 3|
|Contenu 1|Court 2|Contenu 3|
|Contenu 1|Contenu 2|Contenu 3|
affiche :
Colonne 1 | Colonne 2 | Colonne 3 |
---|---|---|
Contenu 1 | Contenu 2 | Contenu long 3 |
Contenu 1 | Court 2 | Contenu 3 |
Contenu 1 | Contenu 2 | Contenu 3 |
Autre exemple :
|Colonne 1||Colonne 3|
|--------------|-----------|------------|
|Contenu 1|l1|Contenu long 3 mais pas trop long|
|Contenu 1|l2|Contenu 3|
|Contenu vraiment très très très long et d'ailleurs on se demande jusqu'où il va aller 1|l3|Contenu 3|
affiche :
Colonne 1 | Colonne 3 | |
---|---|---|
Contenu 1 | l1 | Contenu long 3 mais pas trop long |
Contenu 1 | l2 | Contenu 3 |
Contenu vraiment très très très long et d'ailleurs on se demande jusqu'où il va aller 1 | l3 | Contenu 3 |
Effet d'un retour à la ligne
Le retour à la ligne est interprété par le compilateur mdBook comme un passage à la ligne suivante du tableau.
Par exemple :
|Mon tableau|
|-|
|Ceci est une ligne
Ceci est une nouvelle ligne|
affiche :
Mon tableau |
---|
Ceci est une ligne |
Ceci est une nouvelle ligne |
Optimisations d'écriture
Les |
sont optionnels s'il nous n'avons plus de texte ou de données à saisir dans les colonnes plus à droite.
Si nous n'avons que la première colonne (de gauche) à compléter avec du texte le |
de début de ligne de tableau est également optionnel.
Par exemple (nous éludons tous les |
à droite du dernier texte à écrire) :
|Colonne 1|Colonne 2|Colonne 3
|-|-|-|
|Contenu 1|Contenu 2
|Contenu 1
|Contenu 1|Contenu 2|Contenu 3
affiche :
Colonne 1 | Colonne 2 | Colonne 3 |
---|---|---|
Contenu 1 | Contenu 2 | |
Contenu 1 | ||
Contenu 1 | Contenu 2 | Contenu 3 |
Ou encore (sans le |
de gauche pour la ligne avec un seul contenu) :
|Colonne 1|Colonne 2|Colonne 3
|-|-|-|
|Contenu 1|Contenu 2
Contenu 1
|Contenu 1|Contenu 2|Contenu 3
affiche :
Colonne 1 | Colonne 2 | Colonne 3 |
---|---|---|
Contenu 1 | Contenu 2 | |
Contenu 1 | ||
Contenu 1 | Contenu 2 | Contenu 3 |
Je recommande d'écrire les tableaux « strictement » pour une meilleure lisibilité, c'est-à-dire sans éluder les
|
.
Laisser la première ligne vide
Nous pouvons laisser la première ligne du tableau vide en écrivant cette ligne comme ceci : ||||
(sans éluder les séparateurs de colonnes de tableau |
).
Le tableau s'affiche alors sous cette forme :
Contenu 1 | l1 | Contenu long 3 mais pas trop long |
Contenu 1 | l2 | Contenu 3 |
Contenu vraiment très très très long et d'ailleurs on se demande jusqu'où il va aller 1 | l3 | Contenu 3 |
Changer la présentation d'un tableau
La manière dont le tableau s'affiche est gérée au niveau des feuilles de style du thème de notre projet mdBook.
Cela relève d'un niveau de compétences et de maîtrise que nous abordons dans d'autres pages mdBook de ce Bloc-notes mdBook.
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 version : 23 mars 2023 21:55