Convertir un CSV en tableau Markdown
Écrire un tableau Markdown à la main oblige à compter les barres verticales et les tirets à chaque ligne. Importez plutôt votre CSV et obtenez un tableau avec sa ligne d'en-tête et sa ligne de séparation, prêt à coller dans un README, une page de wiki ou un notebook.
Convertisseur de données
ou déposez Fichiers CSV, TSV, TXT … ici ·
95 Mo max. par fichier· Jusqu'à 20 fichiers· Supprimés après 30 minutes
Les fichiers sont traités sur nos serveurs et supprimés après 30 minutes.
Caractère qui sépare les colonnes dans les fichiers CSV et texte, en lecture comme en écriture. Détection auto le repère dans le fichier source et écrit des virgules.
UTF-8 convient à toutes les langues. Choisissez UTF-8 avec BOM si Excel sous Windows affiche des accents ou des caractères asiatiques illisibles à l’ouverture du CSV.
Fichiers Excel, ODS et Numbers : convertir uniquement la première feuille ou toutes les feuilles (un CSV par feuille dans un ZIP, ou une clé JSON par feuille).
Nom de l’onglet de la feuille dans le nouveau classeur, 31 caractères maximum.
Tableau d’objets utilise les noms de colonnes comme clés pour chaque ligne ; tableau de tableaux est plus compact et conserve l’en-tête comme premier tableau.
Nom de l’élément externe qui regroupe toutes les lignes ; chaque ligne devient un <row> à l’intérieur.
Utilisé dans les instructions CREATE TABLE et INSERT. Lettres, chiffres et tirets bas uniquement.
Les guillemets et les types de colonnes diffèrent légèrement d’une base à l’autre ; choisissez celle dans laquelle vous allez importer.
Réécrit les cellules de date dans un seul format. ISO (2026-10-18) est le plus sûr pour les bases de données et le code ; conserver les laisse telles qu’elles apparaissent dans la source.
Comment utiliser cet outil
- 1
Importez le CSV
Ajoutez des fichiers .csv, .tsv ou .txt délimités, jusqu'à 20 à la fois et 95 Mo chacun. La détection automatique gère les virgules, les points-virgules, les tabulations et les barres verticales.
- 2
Vérifiez l'en-tête
L'option La première ligne contient les en-têtes est activée : la ligne 1 devient donc l'en-tête du tableau. Désactivez-la dans Réglages avancés si votre fichier commence directement par des données.
- 3
Convertissez et collez
Cliquez sur Convertir en tableau Markdown, ouvrez le fichier .md et collez le tableau dans votre README, votre pull request, votre ticket ou votre note.
Comment convertir un fichier CSV en tableau Markdown ?
Importez le CSV et cliquez sur Convertir en tableau Markdown. La première ligne devient l'en-tête du tableau, une ligne de tirets est ajoutée en dessous, et chaque autre ligne devient une rangée dont les cellules sont séparées par des barres verticales.
Pourquoi les développeurs convertissent un CSV en Markdown
La documentation finit toujours dans des fichiers Markdown. Un mainteneur veut un tableau des versions prises en charge dans le README, un ingénieur colle des résultats de benchmark dans une pull request, un chercheur tient sa liste de lectures dans Obsidian. Les chiffres viennent souvent d'un tableur ou de la sortie CSV d'un script, et les reconstituer à la main, avec une barre verticale entre chaque cellule, est long et source d'erreurs.
Le Markdown original de John Gruber, en 2004, ne comportait aucun tableau. La syntaxe à barres verticales s'est diffusée via PHP Markdown Extra puis a été intégrée à la spécification GitHub Flavored Markdown en 2017, ce qui explique qu'elle fonctionne sur GitHub et dans la plupart des outils qui la suivent. Si les lignes viennent d'Excel, enregistrez-les d'abord avec Excel en CSV, puis convertissez-les ici.
Exemple de conversion d'un CSV en tableau Markdown
runtime,version,statut Python,3.13,pris en charge Python,3.9,fin de vie | octobre 2025 Node.js,22,pris en charge
| runtime | version | statut | | --- | --- | --- | | Python | 3.13 | pris en charge | | Python | 3.9 | fin de vie \| octobre 2025 | | Node.js | 22 | pris en charge |
Où s'affiche un tableau Markdown converti
| Organisme | Exigence | Source |
|---|---|---|
| GitHub | Affiche les tableaux à barres verticales dans les README, tickets, pull requests et wikis, conformément à la spécification GFM. | Spécification GFM |
| GitLab | GitLab Flavored Markdown affiche les mêmes tableaux à barres verticales dans les dépôts, tickets et merge requests. | — |
| Obsidian | Affiche les tableaux à barres verticales en mode lecture et propose l'édition de tableaux dans l'aperçu en direct. | — |
| Jupyter | Les cellules Markdown des notebooks affichent les tableaux à barres verticales à côté de votre code. | — |
| CommonMark | La spécification de base ne comporte aucune syntaxe de tableau ; les moteurs de rendu ont besoin d'une extension pour les tableaux. | commonmark.org |
Caractéristiques des formats CSV et Markdown
CSV
Valeurs séparées par des virgules
Le CSV est un format texte brut pour les tableaux, où chaque ligne est une ligne du tableau et où des virgules séparent les colonnes. Il est utilisé depuis les débuts de l'informatique et décrit dans la RFC 4180, bien que de nombreuses variantes utilisent des points-virgules ou des tabulations et différents encodages de texte. Presque tous les tableurs, bases de données et outils d'analyse peuvent l'importer et l'exporter, ce qui en fait le format par défaut pour échanger des données entre systèmes. Le CSV ne stocke que des valeurs, sans formules, mise en forme, feuilles multiples ni types de données.
- Compression
- –
- Transparence
- –
- Animation
- –
- Année de création
- –
MD
Markdown
Markdown est une syntaxe de balisage légère créée par John Gruber en 2004. Elle utilise des symboles en texte brut, comme # pour les titres, * pour l'emphase et - pour les listes, qui restent lisibles en texte brut et se convertissent proprement en HTML. C'est la norme pour les fichiers README, la documentation, les wikis, les applications de notes et de nombreux générateurs de sites statiques. Il existe plusieurs variantes, comme CommonMark et GitHub Flavored Markdown, qui diffèrent sur des détails tels que les tableaux. N'importe quel éditeur de texte peut ouvrir les fichiers .md.
- Compression
- –
- Transparence
- –
- Animation
- –
- Année de création
- 2004 · John Gruber
On convertit du CSV en Markdown quand un petit jeu de données doit vivre dans une documentation : tableau de compatibilité d'un README, liste des versions d'un journal des modifications, pull request comparant des benchmarks ou note dans une base de connaissances personnelle.
La conversion préserve presque intégralement les valeurs, mais pas l'intention. Le CSV conserve chaque ligne pour qu'un logiciel la lise ; un tableau Markdown est une image des données destinée aux humains, sans types, sans formules et sans fusion de cellules. Gardez le CSV dans le dépôt comme source et régénérez le tableau quand les chiffres changent.
FAQ : CSV en Markdown
Où les tableaux Markdown s'affichent-ils ?
Partout où le moteur de rendu prend en charge l'extension des tableaux à barres verticales : GitHub, GitLab, Obsidian, les notebooks Jupyter, ainsi que les générateurs de sites statiques comme MkDocs et Hugo. Un moteur strictement CommonMark affiche les mêmes lignes comme du texte brut, avec les barres verticales visibles.
Que se passe-t-il si une valeur de mon CSV contient une barre verticale ?
Un | non échappé ouvrirait une nouvelle cellule et décalerait toutes les colonnes vers la droite. Le convertisseur l'écrit \|, l'échappement défini par GitHub Flavored Markdown, si bien que la barre verticale s'affiche comme du texte dans la cellule.
Puis-je aligner les nombres à droite ?
Oui, en modifiant la ligne de séparation : ---: aligne une colonne à droite, :---: la centre et :--- l'aligne à gauche. Ajoutez les deux-points après la conversion ; ils changent uniquement l'affichage du tableau, pas les données.
Quelle taille de CSV convient à un tableau Markdown ?
Les tableaux Markdown sont faits pour être lus : quelques dizaines de lignes et une poignée de colonnes donnent le meilleur résultat. Un tableau de plusieurs milliers de lignes se convertit sans problème, mais rend un README pénible à faire défiler ; mettez plutôt un lien vers le fichier CSV du dépôt et affichez un extrait.
Que deviennent les retours à la ligne dans un champ CSV ?
Une ligne de tableau Markdown doit tenir sur une seule ligne : une valeur CSV entre guillemets répartie sur plusieurs lignes ne peut donc pas être conservée telle quelle. Remplacez ces sauts de ligne avant la conversion ; sur GitHub, vous pouvez utiliser <br> dans une cellule pour en forcer un.
Puis-je plutôt convertir le tableau en HTML ?
Si la destination est une page web, un CMS ou un e-mail plutôt qu'un fichier Markdown, réglez Convertir en sur tableau HTML. Pour des données qui sont au départ en JSON, la page JSON en HTML a déjà cette sortie sélectionnée.