Tableaux Markdown : la référence complète

Tout sur les tableaux GFM à barres (version GitHub) — anatomie, alignement, échappement, les erreurs qui cassent le rendu, et le passage des tableaux d'un outil à l'autre.

Syntaxe de base

| Column A | Column B |
|----------|----------|
| cell 1   | cell 2   |
| cell 3   | cell 4   |

Trois parties : une ligne d'en-tête, une ligne de séparation (au minimum des tirets), puis les lignes de corps. La ligne de séparation doit exister — sans elle, le texte est un paragraphe, pas un tableau. Les espacements de la source n'ont pas besoin de s'aligner ; ce sont les barres qui comptent, pas les colonnes. Les barres initiales et finales sont facultatives mais recommandées pour la portabilité.

Alignement

Les deux-points de la ligne de séparation définissent l'alignement des colonnes — :--- à gauche (par défaut), :---: centré, ---: à droite :

| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |

L'alignement est le seul contrôle au niveau des cellules offert par GFM : pas d'arrière-plan de cellule, pas de cellules fusionnées, pas d'étendue de colonnes.

Mise en forme intégrée dans les cellules

Les cellules acceptent le Markdown intégré — gras, italique, code en ligne et liens — mais pas d'éléments en bloc : ni listes, ni titres, ni tableaux imbriqués dans une cellule. Chaque ligne est une ligne source ; les retours longs exigent un <br> explicite.

Erreurs courantes qui cassent les tableaux

Pas de ligne vide avant le tableau — collé contre un paragraphe, la plupart des analyseurs traitent les barres comme du texte.
Ligne de séparation malformée — elle ne doit contenir que des tirets, des deux-points et des barres, avec exactement autant de cellules que la ligne d'en-tête.
Barre non échappée dans une cellule — un | littéral scinde la cellule et décale chaque colonne suivante. Échappez-le en \|.
Lignes inégales — GitHub tolère les cellules finales manquantes (rendues vides), mais certains analyseurs et convertisseurs les signalent ou les complètent ; gardez des longueurs de lignes cohérentes.
Tableaux indentés — quatre espaces initiaux transforment tout le bloc en bloc de code.

Collez un tableau douteux dans le générateur de tableaux — il renormalise l'alignement et l'échappement en forme canonique.

Faire circuler les tableaux vers et depuis d'autres outils

Direction	Outil	Notes
Excel / Sheets → Markdown	Excel vers Markdown	Valeurs en cache seulement ; zéros initiaux préservés en texte
CSV / TSV → Markdown	CSV vers Markdown	RFC-4180 complet : champs cités, virgules embarquées, cellules multilignes
Markdown → Excel / CSV	Tableau Markdown vers Excel	Chaque tableau détecté ; valeurs écrites en texte, jamais coercitées
Markdown → JSON	Markdown vers JSON	La ligne d'en-tête devient les clés ; inférence de types désactivable
En construire ou en reformater un	Générateur de tableaux	Collez des cellules ou un tableau existant ; alignement et échappement normalisés

Les cinq s'exécutent dans votre navigateur, sans téléversement — et la matrice de prise en charge des formats documente la manière dont chaque exporteur traite l'alignement des tableaux, les cellules multilignes et l'échappement.

Tableaux dans GitHub, Reddit et Slack

GitHub rend le GFM complet, alignement et mise en forme intégrés compris ; gardez une ligne vide entre le tableau et le texte qui l'entoure.
Reddit prend en charge les tableaux à barres dans la plupart des contextes (alignement compris), mais pas dans les citations.
Slack et Discord ne rendent pas les tableaux — les barres s'affichent telles quelles. Pour le chat, l'outil Markdown → image rend le tableau en image partageable.

Questions fréquentes

Comment insérer un retour à la ligne dans une cellule de tableau Markdown ?

Utilisez une balise HTML <br> — la règle Markdown des deux espaces pour les retours à la ligne ne fonctionne pas dans une ligne de tableau, car la ligne est un seul long texte. La plupart des moteurs de rendu, GitHub compris, acceptent <br> dans les cellules de tableau.

Markdown prend-il en charge les cellules fusionnées ?

Non. Les tableaux GFM n'ont ni colspan ni rowspan. Pour représenter des données fusionnées, répétez la valeur dans chaque ligne ou restructurez le tableau ; certains préprocesseurs génèrent des cellules répétées à partir de données sources à étendue.

Pourquoi mon tableau Markdown ne se rend-il pas ?

Trois causes habituelles : pas de ligne vide entre le tableau et le paragraphe précédent, une ligne d'alignement malformée (elle ne doit contenir que des barres, des tirets et des deux-points, sur sa propre ligne), ou des barres non échappées dans les cellules qui scindent les lignes prématurément.

Combien de colonnes un tableau Markdown peut-il avoir ?

Le format ne fixe aucune limite — c'est la lisibilité qui le fait. Au-delà d'environ sept colonnes, les lignes deviennent difficiles à balayer en source et débordent souvent de la largeur de page rendue ; envisagez de transposer le tableau ou de le scinder.

Les tableaux Markdown s'affichent-ils correctement dans Word et Excel ?

Pas par simple collage — Word et Excel n'ont pas d'analyseur Markdown. Convertissez d'abord : un convertisseur conscient de la structure transforme les tableaux GFM en tableaux Word modifiables ou en vraies feuilles .xlsx, en préservant lignes d'en-tête, alignement et zéros initiaux.