Comment faire un tableau en Markdown (syntaxe, alignement et générateur gratuit)

Les tableaux sont la seule partie de Markdown pénible à taper : des barres, des tirets et une présentation qui se défait dès qu’une cellule s’allonge. Ils restent utiles dans les fichiers README, la documentation et les notes. Ce guide explique leur fonctionnement et comment éviter la saisie avec le générateur de tableaux Markdown gratuit.

La syntaxe des tableaux Markdown

Un tableau est fait de lignes de texte. Les barres (|) séparent les colonnes, et une ligne de tirets (---) sépare la ligne de titres du reste :

| Plan     | Users | Price |
| -------- | ----- | ----- |
| Free     | 1     | $0    |
| Team     | 10    | $29   |
| Business | 50    | $99   |

Trois règles suffisent :

• La première ligne est toujours la ligne de titres.
• La deuxième ligne doit avoir un groupe de tirets par colonne. Trois tirets par colonne suffisent.
• Laissez une ligne vide avant le tableau, sinon certains lecteurs ne le reconnaissent pas.

Les tableaux ne font pas partie du Markdown d’origine. Ils viennent du Markdown de GitHub, pris en charge par GitHub, GitLab et la plupart des outils modernes. Un lecteur Markdown très strict peut les afficher en texte brut.

Les espaces sont facultatifs

Aligner les colonnes rend seulement le texte brut plus lisible. Cette version plus courte s’affiche exactement de la même façon :

| Plan | Users | Price |
| --- | --- | --- |
| Free | 1 | $0 |
| Team | 10 | $29 |
| Business | 50 | $99 |

Comment aligner les colonnes

Les deux-points dans la ligne de tirets fixent l’alignement de chaque colonne :

• :--- aligne à gauche.
• :---: centre.
• ---: aligne à droite, idéal pour les prix et autres nombres.

| Plan     | Users | Price |
| :------- | :---: | ----: |
| Free     |   1   |    $0 |
| Team     |  10   |   $29 |
| Business |  50   |   $99 |

Barres et retours à la ligne dans une cellule

Une | dans une cellule ouvrirait une nouvelle colonne : écrivez-la donc \|. Une cellule ne contient par ailleurs qu’une seule ligne, un retour à la ligne s’écrit donc <br>, que GitHub affiche comme une nouvelle ligne dans la cellule :

| Command | Meaning |
| --- | --- |
| a \| b | Pipe in a cell |
| Line one<br>Line two | Two lines |

Le gras, l’italique, les liens et `code` fonctionnent normalement dans les cellules. Les listes et les blocs de code non, car ils ont besoin de plusieurs lignes.

Comment créer un tableau sans taper les barres

1. Ouvrez le générateur de tableaux Markdown. Exemple remplit un tableau type.
2. Saisissez dans les cellules ; la première ligne est la ligne de titres. Entrée descend d’une cellule, et + Ligne et + Colonne en ajoutent.
3. Utilisez le menu au-dessus de chaque colonne pour choisir Gauche, Centre ou Droite.
4. Vérifiez le résultat, puis cliquez sur Copier ou Télécharger.

Deux options changent l’aspect du Markdown en texte brut, mais pas son affichage :

• Aligner les colonnes ajoute les espaces qui rendent le texte net. Désactivez-la pour un Markdown plus court.
• Barres aux bords commence et termine chaque ligne par |. Les deux formes fonctionnent sur GitHub.

Comment transformer Excel ou Google Sheets en tableau Markdown

Sélectionnez les cellules dans votre feuille de calcul et copiez-les. Cliquez sur une cellule du générateur et collez : les cellules se remplissent à partir de là, et des lignes et colonnes s’ajoutent si besoin. Vous pouvez aussi cliquer sur Ouvrir un fichier ou déposer un fichier CSV ou TSV sur l’outil. Il prend en charge jusqu’à 500 lignes et 26 colonnes.

Comment modifier un tableau existant

Ouvrez ou déposez un fichier .md, ou collez le tableau Markdown dans une cellule. Le premier tableau trouvé est chargé dans la grille avec son alignement : vous pouvez ajouter une colonne ou changer le texte sans compter les barres.

Autres outils Markdown

• Générateur de README : créez un README complet, puis ajoutez votre tableau. Voir comment écrire un bon README.
• Markdown en HTML : obtenez le tableau en HTML pour votre site.

Questions fréquentes

Puis-je fusionner des cellules dans un tableau Markdown ?

Non. Les tableaux Markdown n’ont pas de cellules fusionnées. Si vous en avez vraiment besoin, utilisez un tableau HTML, que GitHub accepte aussi.

Un tableau Markdown peut-il ne pas avoir de ligne de titres ?

Pas sur GitHub : la ligne de titres est obligatoire. Si vous ne voulez pas de titres, laissez ces cellules vides.

Mon tableau est-il envoyé ?

Non. Il est créé dans votre navigateur et ne quitte jamais votre appareil. Modifier est gratuit ; copier ou télécharger le Markdown compte comme une utilisation de votre quota quotidien.