What is GFM (GitHub Flavored Markdown)?

GFM (GitHub Flavored Markdown) is a superset of standard Markdown developed by GitHub. It adds features not in the original spec including tables, task lists, strikethrough, fenced code blocks, and autolinks. GFM tables use pipes (|) as column separators and dashes (---) with optional colons for alignment in the header separator row.

How do I use a Markdown table in a GitHub README?

Copy the generated Markdown and paste it directly into your README.md file. GitHub's Markdown renderer will display it as a formatted HTML table. The table must have a header row, a separator row (with dashes), and at least one data row. Leading and trailing pipes are optional but recommended for readability.

What are the limits of Markdown tables?

Markdown tables in GFM have some limitations: cells cannot span multiple columns or rows (no colspan/rowspan), cells cannot contain block-level elements like lists or code blocks (only inline formatting), and there is no built-in support for header styling beyond the first row. For complex layouts, use an HTML table directly in Markdown.

What is GitHub Flavored Markdown (GFM)?

GitHub Flavored Markdown (GFM) is GitHub's extension of the CommonMark specification. It adds tables, task lists, strikethrough, and autolinks. The table syntax uses pipe characters (|) and hyphens (---) for alignment. GFM tables are supported by GitHub, GitLab, VS Code, Notion, and most documentation tools.

How do I control column alignment in Markdown tables?

Column alignment is set in the separator row using colons (:). Left align: |:---|, center: |:---:|, right: |---:|. The default (no colon) is usually left-aligned. This generator lets you set alignment per column or apply one alignment globally.

Générateur de tableau Markdown — Outil GFM

Comment fonctionne le générateur de tableau Markdown

Cliquez sur n'importe quelle cellule de la grille pour la modifier. La première ligne est l'en-tête (affichée avec un fond distinct). Utilisez les boutons + et − pour ajouter ou supprimer des colonnes et des lignes — jusqu'à une grille 8×8. Pendant que vous tapez, la sortie Markdown ci-dessous se met à jour en temps réel.

Choisissez l'alignement globalement (toutes les colonnes utilisent le même réglage) ou par colonne (chaque colonne a son propre bouton G/C/D). Le mode "Impression jolie" rembourre les cellules avec des espaces pour aligner verticalement les caractères de pipe — beaucoup plus facile à lire dans un éditeur de texte. Le mode compact produit des pipes de largeur minimale, plus petit mais plus difficile à parcourir.

Le format de tableau GFM expliqué

Les tableaux GitHub Flavored Markdown (GFM) utilisent une syntaxe simple délimitée par des pipes. La première ligne est toujours la ligne d'en-tête. La deuxième ligne est la ligne de séparation, qui utilise des tirets (---) pour indiquer les limites des colonnes. Des deux-points optionnels contrôlent l'alignement : ':---' pour gauche, ':---:' pour centré, '---:' pour droite. Chaque ligne suivante est une ligne de données. Les pipes de début et de fin sont optionnels mais fortement recommandés pour la clarté.

Les tableaux GFM sont pris en charge sur GitHub, GitLab, Bitbucket, Notion, Obsidian, Bear, l'aperçu Markdown VS Code et la plupart des moteurs de rendu Markdown modernes. CommonMark standard n'inclut pas les tableaux, donc ils peuvent ne pas se rendre dans tous les environnements. La syntaxe est suffisamment propre pour que même le texte brut non rendu soit encore lisible.

Conseils pour de meilleurs tableaux Markdown

Gardez les cellules concises. Un contenu de cellule très long rend les tableaux difficiles à lire même avec l'impression jolie. Si une colonne contient principalement des chiffres, alignez-la à droite — cela rend les valeurs plus faciles à comparer visuellement. Utilisez l'alignement centré avec parcimonie, généralement uniquement pour les étiquettes courtes ou les valeurs de statut.

Le formatage Markdown inline fonctionne à l'intérieur des cellules de tableau : **gras**, *italique*, `code` et [liens](url) se rendent tous correctement. Cependant, vous ne pouvez pas utiliser d'éléments de niveau bloc comme des titres, des listes ou des blocs de code dans une cellule. Si vous avez besoin de contenu complexe dans un tableau, envisagez d'écrire un tableau HTML brut dans votre fichier Markdown — la plupart des moteurs de rendu prennent en charge le passage HTML brut.

Quand utiliser les tableaux Markdown

Les tableaux Markdown conviennent parfaitement aux fichiers README (GitHub, GitLab), aux sites de documentation (MkDocs, Docusaurus, Hugo), aux descriptions de pull requests, aux pages Notion, et à toute plateforme prenant en charge CommonMark ou GFM (GitHub Flavored Markdown). Ils sont idéaux pour les données comparatives, les références d'API, les matrices de fonctionnalités et les ensembles de données structurées qui doivent rester lisibles en format brut.

Combinez cet outil avec Text Diff pour comparer des versions de tableaux, Générateur Lorem Ipsum pour remplir des cellules fictives, Générateur de slug pour les identifiants de colonnes, ou Convertisseur de casse pour normaliser les noms d'en-têtes.

Référence de syntaxe des tableaux Markdown

Un tableau GFM utilise | pour séparer les colonnes et --- pour la ligne séparatrice de l'en-tête. Les deux-points contrôlent l'alignement : --- (gauche), :---: (centré), ---: (droite). Exemple :

| Name   | Score | Grade |
|--------|------:|:-----:|
| Alice  |    95 |   A   |
| Bob    |    82 |   B   |

Tous les dialectes Markdown ne supportent pas les tableaux — CommonMark standard ne le fait pas, mais GFM (GitHub), MultiMarkdown et Pandoc oui. En cas de doute, utilisez un <table> HTML pour une compatibilité maximale.

Questions fréquentes

Qu'est-ce que GFM (GitHub Flavored Markdown) ?

GFM est un sur-ensemble de Markdown standard développé par GitHub. Il ajoute des tableaux, des listes de tâches, le barré, les blocs de code délimités et les liens automatiques. Les tableaux GFM utilisent des pipes comme séparateurs de colonnes et des tirets avec des deux-points optionnels pour l'alignement. Il est pris en charge par GitHub, GitLab, Notion, Obsidian et la plupart des outils Markdown modernes.

Comment utiliser un tableau Markdown dans un README GitHub ?

Copiez le Markdown généré et collez-le directement dans votre fichier README.md. GitHub le rendra comme un tableau HTML formaté. Le tableau doit avoir une ligne d'en-tête, une ligne de séparation (tirets) et au moins une ligne de données. Les pipes de début et de fin sont optionnels mais recommandés.

Quelles sont les limites des tableaux Markdown ?

Les tableaux GFM ne peuvent pas s'étendre sur plusieurs colonnes ou lignes (pas de colspan/rowspan), et les cellules ne peuvent pas contenir d'éléments de niveau bloc comme des listes ou des titres. Il n'y a pas de prise en charge intégrée des cellules fusionnées ou des mises en page complexes. Pour les tableaux complexes, utilisez du HTML brut dans votre fichier Markdown.

Qu'est-ce que GitHub Flavored Markdown (GFM) ?

GitHub Flavored Markdown (GFM) est l'extension de la spécification CommonMark par GitHub. Il ajoute les tableaux, les listes de tâches, le barré et les liens automatiques. La syntaxe de tableau utilise des pipes (|) et des tirets (---) pour l'alignement. Les tableaux GFM sont supportés par GitHub, GitLab, VS Code, Notion et la plupart des outils de documentation.

Comment contrôler l'alignement des colonnes dans les tableaux Markdown ?

L'alignement des colonnes se définit dans la ligne de séparation avec des deux-points (:). Alignement gauche : |:---|, centré : |:---:|, droite : |---:|. Par défaut (sans deux-points), l'alignement est généralement à gauche. Ce générateur vous permet de définir l'alignement par colonne ou d'appliquer un alignement global.

Les tableaux Markdown fonctionnent-ils dans tous les éditeurs Markdown ?

Non. Les tableaux sont une extension de GitHub Flavored Markdown (GFM), absente de la spécification CommonMark d'origine. Ils fonctionnent dans GitHub, GitLab, Notion, Obsidian, MkDocs et la plupart des éditeurs modernes, mais pas dans les rendus CommonMark stricts. Si la compatibilité est critique, utilisez un tableau HTML.

Comment inclure un caractère barre verticale dans une cellule de tableau ?

Échappez-le avec un antislash : \|. Cela indique au parseur Markdown que la barre verticale est un contenu littéral, pas un séparateur de colonne. Certains parseurs acceptent aussi l'entité HTML |.

Vous pourriez aussi avoir besoin de

Voir tous les outils →

Outils complémentaires basés sur ce que vous faites

🔗

Générateur de slugGénérez des slugs d'URL

📋

Formateur JSON & ValidateurFormatez des données JSON

🔍

Testeur d'expressions régulièresTestez des expressions régulières

🔠

Convertisseur de casseConvertissez la casse du texte

Par Bam's Thinkery — Mis à jour le 2 mai 2026