CSV en tableau Markdown : convertir un CSV pour GitHub, un README ou une documentation
Transformez un CSV en tableau Markdown pour GitHub, un README ou une doc : alignement par colonne, barres verticales et sauts de ligne sans casse, limites de taille.
Mis à jour le 8 novembre 202610 min de lecture
Pour transformer un CSV en tableau Markdown, déposez le fichier dans un convertisseur CSV vers Markdown, vérifiez l'aperçu rendu, réglez l'alignement de chaque colonne et copiez le résultat dans votre README, votre issue ou votre page de documentation. Le convertisseur écrit les trois parties dont tout tableau Markdown a besoin : une ligne d'en-tête, une ligne de séparation faite de tirets et une ligne par enregistrement. Le plus délicat n'est pas la structure, ce sont les cellules : une barre verticale, un saut de ligne dans un champ entre guillemets ou un astérisque isolé peuvent couper une ligne, décaler des données dans la mauvaise colonne ou passer du texte en italique. Ce guide couvre les étapes, l'alignement, ces caractères à problèmes et les limites de taille à connaître avant de coller.
Comment convertir un CSV en tableau Markdown
Ajoutez le CSV
Ouvrez le convertisseur CSV en Markdown et déposez un fichier .csv, .tsv, .txt ou .psv. Le délimiteur, le caractère de guillemet et l'encodage sont détectés à partir du fichier lui-même, et l'outil vous indique ce qu'il a choisi.
Vérifiez la ligne d'en-tête
Laissez Première ligne comme en-tête activé quand la première ligne contient les noms de colonnes. Désactivez-le si le fichier commence directement par des données ; le tableau reçoit alors des libellés générés Col 1, Col 2.
Réglez l'alignement
Choisissez un Alignement par défaut pour tout le tableau, puis modifiez n'importe quelle colonne depuis le menu déroulant de son en-tête dans l'aperçu. Les nombres se lisent généralement mieux alignés à droite.
Vérifiez l'aperçu sous ses deux formes
Basculez entre Rendu et Markdown. La vue rendue montre si une cellule contenant un astérisque ou un saut de ligne se comporte bien ; la vue brute montre exactement ce que vous allez coller.
Copiez ou téléchargez
Appuyez sur Convertir en Markdown, puis sur Copier le Markdown pour un README ou une pull request, ou sur Télécharger le .md avec le nom saisi dans Télécharger sous.
De quoi se compose un tableau Markdown
Un tableau Markdown dans le dialecte GitHub-Flavored est du texte brut. La première ligne est l'en-tête, avec des cellules séparées par des barres verticales. La deuxième ligne est le séparateur : des tirets sous chaque colonne, et c'est sa présence qui fait du bloc un tableau. Chaque ligne suivante est un enregistrement. GitHub, GitLab, Obsidian, VS Code et la plupart des générateurs de sites statiques lisent ce même format : un tableau converti fonctionne donc partout.
Le format a des limites strictes qu'il vaut mieux connaître avant de commencer. Impossible de fusionner des cellules sur plusieurs lignes ou colonnes, chaque ligne doit tenir sur une seule ligne de texte et l'en-tête est toujours affiché en gras. Si une ligne du CSV compte moins de cellules que l'en-tête, le convertisseur la complète par des cellules vides ; si elle en compte plus, le tableau est élargi à la ligne la plus large, pour que rien ne soit coupé en silence.
L'alignement des colonnes dans un tableau Markdown
L'alignement se trouve uniquement dans la ligne de séparation, sous forme de deux-points placés à côté des tirets. Le convertisseur les écrit pour vous, et peut en écrire un différent pour chaque colonne :
| Alignement | Séparateur écrit | Idéal pour |
|---|---|---|
| Gauche | :--- | Noms, libellés, texte libre |
| Centre | :---: | Colonnes de statut courtes, oui/non, marques d'un caractère |
| Droite | ---: | Prix, quantités, pourcentages |
| Aucun | --- | Laisser le choix au moteur de rendu (à gauche presque partout) |
Le cas courant est un tableau qui mélange un nom de produit avec un prix et un stock : réglez l'alignement par défaut sur Gauche, puis passez les deux colonnes de chiffres sur Droite dans leurs en-têtes de l'aperçu. Des chiffres alignés à droite se calent sur leur dernier chiffre, et c'est ce qui permet de comparer une colonne de nombres d'un coup d'œil. Notez que certaines applications ignorent les deux-points ; Notion, par exemple, transforme un tableau Markdown collé en son propre tableau et abandonne l'alignement.
Alignement par colonne, échappement sûr des barres verticales et des sauts de ligne, sortie alignée ou compacte, copie ou téléchargement en .md. Gratuit : un CSV jusqu'à 25 Mo, sans limite de lignes, toutes les options de mise en forme incluses. Pro : jusqu'à 50 fichiers à la fois dans un ZIP ou dans un seul document fusionné. Tout est traité sur votre appareil, pas sur nos serveurs.
Convertir CSV en MarkdownBarres verticales, sauts de ligne et caractères qui cassent un tableau
Le texte d'un tableur ne sait pas qu'il va devenir du Markdown. Voici les caractères qui posent problème, et ce que le convertisseur fait de chacun :
| Dans une cellule | Ce qui se passe sans échappement | Ce que fait le convertisseur |
|---|---|---|
| Une barre verticale | | Elle ferme la cellule trop tôt ; la ligne gagne une colonne et les données se décalent | Toujours échappée en \| |
| Une barre oblique inverse | Elle peut avaler le caractère qui la suit | Toujours doublée, pour qu'un chemin Windows survive |
| Un saut de ligne dans un champ entre guillemets | La ligne s'arrête au milieu de la cellule et la suite du tableau s'effondre | Devient <br> par défaut, ou un \n littéral, ou une espace |
| Astérisques, tirets bas, accents graves | Le texte passe en gras, en italique ou en code | Échappés seulement si Échapper les caractères Markdown est activé |
| Crochets, chevrons, tildes | Peuvent devenir des liens, du HTML ou du texte barré | Échappés par la même option |
| Traits d'union, points, signes plus | Rien, dans une cellule de tableau | Laissés tels quels, pour que dates et prix restent lisibles |
Le réglage des sauts de ligne s'appelle Sauts de ligne dans une cellule. Gardez <br> pour GitHub et GitLab, où il s'affiche comme un vrai retour à la ligne et où une adresse postale reste une seule cellule lisible. Choisissez \n littéral quand le tableau part vers un outil qui supprime le HTML et que vous voulez quand même voir qu'il y avait un saut. Choisissez Espace quand les sauts sont un accident de l'export, comme du texte renvoyé à la ligne dans une colonne de tableur.
Laissez Échapper les caractères Markdown désactivé, sauf si l'aperçu montre un problème. La plupart des tableaux ne contiennent aucun de ces caractères, et avec l'option activée chacun reçoit une barre oblique inverse visible dans le fichier brut. Une cellule contenant une valeur comme _brouillon_ ou un mot entouré d'astérisques est justement le cas où vous en avez besoin : sans échappement, elle s'affiche en italique et les marques disparaissent.
D'abord, bien lire le CSV
Beaucoup de tableaux cassés le sont avant même qu'une ligne de Markdown soit écrite, parce que le CSV a été découpé sur le mauvais caractère. Le convertisseur teste la virgule, le point-virgule, la tabulation et la barre verticale sur un échantillon, garde celui qui donne les largeurs de ligne les plus cohérentes et vous prévient si la lecture semble incertaine. Les exports européens utilisent souvent le point-virgule ; si l'aperçu affiche tout dans une seule colonne, réglez le Délimiteur à la main.
- Encodage : si les noms accentués s'affichent en caractères bizarres, le fichier est probablement en Windows-1252 et non en UTF-8. Réglez-le à la main ; un fichier qui porte une marque d'ordre des octets (BOM) l'emporte toujours, et la marque invisible qu'ajoute l'export CSV UTF-8 d'Excel est supprimée pour qu'elle ne colle pas à votre premier titre de colonne.
- Sauter les lignes de tête : les exports de rapports ont souvent un titre et une date au-dessus du véritable en-tête. Sautez-les pour que la première ligne devienne l'en-tête.
- Supprimer les lignes vides et Supprimer les colonnes vides : les exports de tableur accumulent des lignes vides en bas et des colonnes inutilisées sur le côté. Chacune deviendrait des cellules vides dans votre tableau.
- Limiter les lignes : un README a besoin des 20 premières lignes d'un gros export, pas de toutes. 0 conserve toutes les lignes.
Si le tableau doit avoir moins de colonnes que le CSV, retirez-les d'abord avec Ajouter ou supprimer des colonnes CSV, et consultez supprimer des colonnes d'un CSV pour les détails. Un tableau de quatre colonnes bien choisies se lit bien mieux qu'un tableau de douze.
Limites de taille : le convertisseur et l'endroit où vous collez
En version gratuite, le convertisseur accepte un fichier jusqu'à 25 Mo, sans limite de lignes. Le site mesure qu'un export de 25 Mo d'environ 225 000 lignes se convertit en une seconde environ sur un ordinateur de bureau. L'aperçu n'affiche que les premières lignes et colonnes pour que la page reste fluide, mais le téléchargement et le texte copié les contiennent toutes. Pro convertit jusqu'à 50 fichiers à la fois, soit dans un ZIP, soit fusionnés dans un seul document Markdown où chaque tableau est placé sous un titre tiré de son nom de fichier.
La limite la plus stricte vient généralement de la destination, pas du convertisseur :
| Destination | Limite pratique | Que faire |
|---|---|---|
| Issue, pull request ou commentaire GitHub | Le corps est plafonné à 65 536 caractères | Utilisez Limiter les lignes, ou versionnez le tableau dans un fichier .md |
| README ou fichier de documentation dans un dépôt | Pas de petit plafond, mais un très long tableau se lit mal | Montrez un extrait et mettez un lien vers le CSV complet |
| Toute page lue sur un téléphone | Les tableaux larges défilent horizontalement | Tenez-vous à 4 à 6 colonnes environ |
| Texte brut dans un éditeur | Le remplissage rend chaque ligne aussi large que la valeur la plus large | Utilisez la sortie compacte pour les cellules de texte longues |
N'oubliez pas que le Markdown pèse plus lourd que le CSV d'origine : chaque cellule gagne des barres et des espaces, et le remplissage en ajoute encore. Un export complet a rarement sa place dans un document. Vingt lignes bien choisies avec un lien vers le fichier source, c'est ce que veulent la plupart des lecteurs.
D'autres options utiles
- Numéroter les lignes ajoute une colonne de numéros, pratique quand des relecteurs doivent écrire « la ligne 14 est fausse » dans un commentaire.
- Première ligne de données en gras et Première colonne en gras ne s'appliquent qu'au corps, car l'en-tête est déjà en gras au rendu.
- Caractère de guillemet peut être réglé sur guillemet double, apostrophe ou aucun ; un guillemet n'ouvre un champ qu'en tout début de valeur, donc l'apostrophe de O'Brien reste du texte.
Quand un tableau Markdown n'est pas le bon choix
Les tableaux Markdown conviennent à de petites données lisibles au sein d'un texte. Si quelqu'un doit trier, filtrer ou calculer, fournissez les données sous forme de feuille de calcul avec CSV en Excel. Si un programme doit les lire, CSV en JSON est le meilleur format. Si vous voulez seulement parcourir un gros fichier avant de choisir des lignes, ouvrez-le d'abord dans la visionneuse CSV.
Si votre tableau se trouve dans un document Word plutôt que dans un CSV, le travail est différent : les titres, les listes et la mise en forme viennent avec. C'est expliqué dans convertir Word en Markdown, avec l'outil Word en Markdown.
Questions fréquentes
Comment convertir un CSV en tableau Markdown ?
Déposez le CSV dans le convertisseur CSV en Markdown, laissez Première ligne comme en-tête activé si la première ligne contient les noms de colonnes, réglez l'alignement, puis appuyez sur Convertir en Markdown et copiez le résultat ou téléchargez-le en fichier .md. La ligne d'en-tête, la ligne de séparation et l'échappement sont écrits pour vous.
Comment aligner une colonne à droite dans un tableau Markdown ?
Placez deux-points à l'extrémité droite du séparateur de cette colonne, soit ---:. Dans le convertisseur, cela se règle depuis le menu déroulant de l'en-tête de la colonne dans l'aperçu : les colonnes de chiffres peuvent être à droite tandis que le texte reste à gauche.
Comment mettre une barre verticale dans une cellule de tableau Markdown ?
Échappez-la en \| pour qu'elle ne soit pas lue comme la fin de la cellule. Le convertisseur le fait automatiquement pour chaque barre verticale, y compris dans du texte qui ressemble à du code.
Une cellule de tableau Markdown peut-elle contenir un saut de ligne ?
Pas directement : chaque ligne du tableau doit tenir sur une seule ligne. Sur GitHub et GitLab, un <br> dans la cellule s'affiche comme un retour à la ligne, et c'est le choix par défaut du convertisseur pour les champs CSV sur plusieurs lignes. Vous pouvez aussi choisir un \n littéral ou une simple espace.
Pourquoi tout mon CSV s'affiche-t-il dans une seule colonne ?
Le fichier utilise un autre délimiteur que celui appliqué, le plus souvent un point-virgule dans les exports des versions européennes d'Excel. Réglez le Délimiteur à la main sur Point-virgule, Tabulation ou Barre verticale et les colonnes se séparent.
Y a-t-il une limite de taille pour convertir un CSV en Markdown ?
La version gratuite convertit un fichier jusqu'à 25 Mo, sans limite de lignes et avec toutes les options de mise en forme. Pro traite jusqu'à 50 fichiers à la fois. La limite la plus fréquente est la destination : GitHub plafonne le corps d'une issue ou d'une pull request à 65 536 caractères, utilisez donc Limiter les lignes pour les tableaux collés là.