Tableaux Markdown : comment les écrire et les lire

Un tableau Markdown est du texte brut qui se transforme en grille. Tu tapes des mots, des barres verticales | et des tirets -. Un lecteur Markdown affiche des lignes et des colonnes.

Les tableaux sont partout dans les fichiers Markdown : listes de prix, plans, comparaisons, résultats de tests. Les chats IA et les agents de programmation en écrivent tout le temps.

Le tableau de base

| Fruit  | Couleur | Prix  |
|--------|---------|-------|
| Pomme  | Rouge   | 1.20  |
| Banane | Jaune   | 0.50  |

Voici ce que cela affiche :

FruitCouleurPrix
PommeRouge1.20
BananeJaune0.50

Trois sortes de lignes :

  1. La ligne d’en-tête : les noms des colonnes.
  2. 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.
  3. 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  |
GaucheCentreDroite
ab1.20
aabb10.50

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

Les tableaux larges

Un tableau avec beaucoup de colonnes devient large, surtout sur un téléphone. Quelques conseils :

Des moyens rapides de créer un tableau

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)