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 du tableau
Ceci est une nouvelle ligne du tableau|
affiche :
| Mon tableau |
|---|
| Ceci est une ligne du tableau |
| Ceci est une nouvelle ligne du tableau |
Nous pouvons utiliser le <br> HTML pour insérer une nouvelle ligne en veillant bien à ne pas effectuer de retour à la ligne dans notre code source :
|Mon tableau|
|-|
|Ceci est une ligne du tableau<br>Ceci est une nouvelle ligne dans la même cellule de tableau|
affiche :
| Mon tableau |
|---|
| Ceci est une ligne du tableau Ceci est une nouvelle ligne dans la même cellule de tableau |
Optimisations d’écriture
Les | sont optionnels si nous n’avons plus de texte à 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 « rigoureusement » 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 |).
Ce code
||||
|--------------|-----------|------------|
|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|
s’affiche 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 livre.