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 1Colonne 2Colonne 3
Contenu 1Contenu 2Contenu long 3
Contenu 1Court 2Contenu 3
Contenu 1Contenu 2Contenu 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 1Colonne 3
Contenu 1l1Contenu long 3 mais pas trop long
Contenu 1l2Contenu 3
Contenu vraiment très très très long et d'ailleurs on se demande jusqu'où il va aller 1l3Contenu 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 1Colonne 2Colonne 3
Contenu 1Contenu 2
Contenu 1
Contenu 1Contenu 2Contenu 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 1Colonne 2Colonne 3
Contenu 1Contenu 2
Contenu 1
Contenu 1Contenu 2Contenu 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 1l1Contenu long 3 mais pas trop long
Contenu 1l2Contenu 3
Contenu vraiment très très très long et d'ailleurs on se demande jusqu'où il va aller 1l3Contenu 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