Générateur de tableaux Markdown — CSV/TSV en GFM

Recopier un export tableur dans un README à la main est fastidieux, et une seule barre verticale oubliée suffit à casser le rendu. Cet outil lit vos données délimitées avec un analyseur conforme à la RFC 4180, puis les restitue sous forme de tableau Markdown compatible GitHub Flavored Markdown. Les colonnes sont complétées par des espaces pour rester alignées dans le fichier source, et l'alignement visuel du rendu se règle en un clic. Tout se passe dans votre navigateur : vos données ne quittent pas votre machine.

Qu'est-ce qu'un générateur de tableaux Markdown ?

C'est un convertisseur qui prend des données délimitées — CSV, TSV ou colonnes séparées par des points-virgules — et écrit à votre place la syntaxe d'un tableau GitHub Flavored Markdown : ligne d'en-tête, ligne de séparation, puis lignes de données. Il ne se contente pas d'insérer des barres verticales : il interprète les champs entre guillemets, neutralise les caractères qui casseraient le tableau et calibre la largeur de chaque colonne pour que le Markdown brut reste lisible, y compris dans un diff Git.

Comment fonctionne le générateur de tableaux

Le texte collé est analysé par un lecteur conforme à la RFC 4180, pas par un simple split : un champ entre guillemets peut contenir le séparateur, un saut de ligne ou des guillemets doublés valant un guillemet littéral. Si vous laissez le séparateur en automatique, la première ligne est inspectée à la recherche de tabulations, points-virgules et virgules, et le plus fréquent l'emporte. Chaque cellule est ensuite échappée pour Markdown : une barre verticale devient \| et les sauts de ligne internes se réduisent à une espace, car une ligne de tableau GFM doit tenir sur une seule ligne. Enfin, chaque colonne est complétée à la largeur de sa cellule la plus longue, pour que le Markdown brut reste lisible dans un diff, même si ce remplissage ne change rien au rendu.

Ce que fait l'outil

Analyse conforme à la RFC 4180 : champs entre guillemets, guillemets doublés ("") et retours à la ligne à l'intérieur d'un champ.

Détection du délimiteur à partir de la première ligne — tabulation, point-virgule ou virgule — avec possibilité de forcer votre choix.

Neutralisation des caractères dangereux : les barres verticales deviennent \| et les retours à la ligne d'une cellule sont aplatis.

Colonnes complétées à largeur égale et ligne de séparation adaptée à l'alignement : ---, :-: ou --:.

Comment utiliser le générateur

Collez vos données CSV ou TSV dans le champ de saisie — un copier-coller depuis un tableur convient parfaitement.

Laissez le délimiteur sur « Détection automatique » ou imposez la virgule, le point-virgule ou la tabulation si la détection se trompe.

Choisissez l'alignement des colonnes (gauche, centré ou droite) et indiquez si la première ligne doit servir d'en-tête.

Copiez le tableau Markdown généré et collez-le dans votre README, votre ticket ou votre documentation.

Erreurs fréquentes

Oublier les guillemets autour d'un champ qui contient le délimiteur : sans eux, « Dupont, Marie » est coupé en deux colonnes.

Forcer un délimiteur qui ne correspond pas au fichier : un export français en points-virgules traité comme du CSV à virgules ne donne qu'une seule colonne.

S'attendre à retrouver un saut de ligne à l'intérieur d'une cellule : il est aplati, car le Markdown GFM ne permet pas de tableau multiligne dans une cellule.

Exemples concrets

nom,ville\nZoé,Lyon → | nom | ville |\n| --- | ----- |\n| Zoé | Lyon |

code,regex\nor,a|b → | code | regex |\n| ---- | ----- |\n| or | a\|b |

libellé,montant\n"Total ""net""",12 → | libellé | montant |\n| ----------- | ------- |\n| Total "net" | 12 |

Voir aussi

CSV vers JSON — Vous voulez ces lignes en données structurées plutôt qu'en tableau ? Convertissez-les en JSON.
Supprimer les espaces — Des espaces de début oubliés se retrouveront dans chaque cellule — nettoyez-les avant.

FAQ

Comment le délimiteur est-il détecté ?

La première ligne de vos données est examinée pour y repérer une tabulation, un point-virgule ou une virgule, et le séparateur retenu s'applique à tout le contenu. Si votre première ligne est atypique — un en-tête sur une seule colonne, par exemple — sélectionnez le délimiteur vous-même dans la liste.

Que deviennent les barres verticales et les retours à la ligne présents dans une cellule ?

Chaque barre verticale est échappée en \| et les retours à la ligne internes à une cellule sont aplatis. Ces deux transformations sont indispensables : une barre verticale non échappée créerait une colonne fantôme et un retour à la ligne couperait la ligne du tableau en deux.

Les champs entre guillemets sont-ils correctement gérés ?

Oui, l'analyseur suit la RFC 4180 : un champ entouré de guillemets peut contenir le délimiteur, des retours à la ligne et des guillemets doublés, où "" représente un guillemet littéral. Ainsi, "Total ""net""" est bien restitué comme la valeur Total "net" dans une seule cellule.

Pourquoi le Markdown généré contient-il autant d'espaces ?

Chaque colonne est complétée par des espaces jusqu'à la largeur de sa cellule la plus longue. Ce remplissage n'a aucun effet sur le rendu final, mais il rend le Markdown brut lisible et facilite la relecture d'un diff Git lorsqu'une seule valeur change.