Le tableau de base
| Fruit | Couleur | Prix |
|--------|---------|-------|
| Pomme | Rouge | 1.20 |
| Banane | Jaune | 0.50 |
Voici ce que cela affiche :
| Fruit | Couleur | Prix |
|---|---|---|
| Pomme | Rouge | 1.20 |
| Banane | Jaune | 0.50 |
Trois sortes de lignes :
- La ligne d’en-tête : les noms des colonnes.
- La ligne de tirets : elle sépare l’en-tête du reste. Elle est obligatoire. Sans elle, il n’y a pas de tableau.
- Les lignes de données : une ligne de texte par ligne de tableau.
Les barres verticales | séparent les cellules. Les barres au début et à la fin de chaque ligne sont facultatives, mais elles rendent le tableau plus facile à lire.
Les colonnes n’ont pas besoin d’être alignées dans ton texte. Ceci fonctionne aussi :
| Fruit | Couleur | Prix |
|---|---|---|
| Pomme | Rouge | 1.20 |
Laisse une ligne vide avant et après le tableau. Le tableau se termine à la première ligne vide.
Aligner les colonnes
Ajoute des deux-points : à la ligne de tirets :
| Gauche | Centre | Droite |
|:-------|:------:|-------:|
| a | b | 1.20 |
| aa | bb | 10.50 |
| Gauche | Centre | Droite |
|---|---|---|
| a | b | 1.20 |
| aa | bb | 10.50 |
:---à gauche:---:au centre---:à droite (pratique pour les nombres)
Mettre en forme dans une cellule
Les cellules peuvent contenir du gras, de l’italique, du code et des liens :
| Tâche | Statut | Lien |
|-----------|------------|------------------------------|
| Écrire | **Fait** | [Notes](https://example.com) |
| `npm test`| *En cours* | |
Pour mettre une barre verticale dans une cellule, écris-la \|. Sinon, elle commence une nouvelle cellule. Cela vaut aussi à l’intérieur de code.
Ce que les tableaux ne savent pas faire
- Pas de cellules fusionnées. Chaque ligne a les mêmes colonnes.
- Pas de listes ni de paragraphes dans une cellule. Une cellule contient une seule ligne de texte.
- L’en-tête et la ligne de tirets doivent correspondre. Si l’en-tête a trois cellules, la ligne de tirets doit en avoir trois aussi. Sinon, tu obtiens du texte brut au lieu d’un tableau.
- Les lignes peuvent être plus courtes ou plus longues. Une ligne courte reçoit des cellules vides. Les cellules en trop à la fin d’une ligne longue sont ignorées.
Les tableaux larges
Un tableau avec beaucoup de colonnes devient large, surtout sur un téléphone. Quelques conseils :
- Garde des cellules courtes. Déplace les textes longs sous le tableau.
- Découpe un grand tableau en deux plus petits.
- Mets la colonne la plus importante en premier.
Des moyens rapides de créer un tableau
- À partir d’un tableur : de nombreux convertisseurs en ligne transforment des cellules copiées en tableau Markdown.
- À partir d’un chat IA : demande « un tableau Markdown » et précise les colonnes voulues. Si le chat affiche un tableau mis en forme, demande-lui de placer le Markdown dans un bloc de code pour que tu puisses copier le texte.
Lire les tableaux Markdown
Dans un éditeur de texte brut, un tableau reste fait de barres verticales et de tirets. C’est lisible pour les petits tableaux, mais difficile pour les grands. Un lecteur Markdown affiche la vraie grille.
PilcrowMD affiche les tableaux Markdown sur Android et Mac. Les cellules peuvent afficher du gras, de l’italique, des liens et des formules mathématiques. Sur Android, un tableau large défile latéralement, pour que les colonnes ne soient pas écrasées.
Questions fréquentes
Un tableau Markdown est-il le même partout ? Presque. Les tableaux font partie de GitHub Flavored Markdown, que suivent la plupart des applications. Quelques applications Markdown très simples n’affichent pas du tout les tableaux.
Puis-je ajouter un retour à la ligne dans une cellule ? Pas en Markdown standard. Certaines applications acceptent la balise HTML <br>, mais pas toutes.
Dois-je aligner les barres verticales ? Non. Cela rend seulement le texte plus facile à lire.
Aussi sur Mac : PilcrowMD pour Mac (bêta)