Convertir CSV en Markdown

1. 1

   Déposez le CSV

   Faites glisser un fichier .csv, .tsv, .txt ou .psv sur la page, ou parcourez vos fichiers. Le délimiteur, le caractère de guillemet et l'encodage sont lus dans le fichier lui-même, et l'outil indique ce qu'il a retenu.

2. 2

   Vérifiez l'aperçu rendu

   L'aperçu montre le tableau tel qu'il sera rendu, pas seulement le texte brut — vous voyez donc tout de suite si une cellule contenant un astérisque ou un saut de ligne va se comporter correctement.

3. 3

   Réglez l'alignement et la mise en forme

   Choisissez un alignement pour tout le tableau ou par colonne depuis l'en-tête de l'aperçu. Activez la sortie alignée pour un texte brut lisible, l'échappement pour les cellules contenant des caractères Markdown, les lignes numérotées, ou une première ligne ou colonne en gras.

4. 4

   Copiez ou téléchargez

   Cliquez sur Convertir, puis sur Copier pour mettre le tableau dans le presse-papiers pour un README ou une pull request, ou téléchargez-le en .md avec le nom de votre choix. Tout s'exécute sur votre appareil.

Convertissez un CSV en tableau Markdown façon GitHub, avec les deux choses qui décident si le résultat est exploitable : un échappement correct et le contrôle de l'alignement de chaque colonne. Utilisez la première ligne comme en-tête ou générez des libellés, réglez l'alignement pour le tableau ou par colonne, alignez la sortie ou gardez-la compacte, et voyez le tableau rendu à côté du Markdown brut avant de le copier.

• Format de tableau Markdown — Markdown façon GitHub : une ligne d'en-tête, une ligne de séparation portant l'alignement, puis une ligne par enregistrement. Cela se rend dans GitHub, GitLab, Obsidian, Notion, VS Code, Jira et Confluence sans modification.
• Alignement par colonne — Définissez une valeur par défaut pour le tableau, puis remplacez n'importe quelle colonne depuis la liste déroulante de son en-tête dans l'aperçu. Gauche, centre, droite ou aucun.
• Première ligne comme en-tête — Utilisez la première ligne du CSV comme en-tête, ou désactivez cette option pour traiter toutes les lignes comme des données avec des libellés Col 1, Col 2 générés.
• Un échappement qui tient — Les barres verticales et les antislashs sont toujours échappés, les sauts de ligne dans une cellule deviennent <br>, et les astérisques, tirets bas, accents graves, crochets, chevrons et tildes peuvent l'être aussi.
• Alignée ou compacte — Alignez chaque colonne pour que le fichier brut soit lisible dans un éditeur de texte, ou gardez-le compact pour qu'un tableau régénéré produise le plus petit diff possible.
• Aperçu rendu et vue brute — Voyez le tableau tel qu'il sera rendu et le Markdown tel qu'il sera écrit, et basculez entre les deux. Chaque réglage modifie au moins l'un des deux.
• Copier ou télécharger — Mettez le tableau directement dans le presse-papiers pour un README ou une pull request, ou téléchargez-le en .md avec le nom de votre choix.

Un tableau Markdown, ce sont trois sortes de lignes, et savoir laquelle est laquelle explique toutes les options de cette page. L'outil écrit les trois pour vous, mais la forme mérite d'être comprise car c'est elle qui décide où un tableau casse.

L'en-tête et la ligne de séparation

• Ligne d'en-tête — Une ligne de cellules entre barres verticales. Elle est toujours en gras au rendu, d'où le fait que la remettre en gras ne fait rien et que les options de gras de cet outil s'appliquent au corps.
• Ligne de séparation — La ligne de tirets juste sous l'en-tête. Ce n'est pas de la décoration : sa présence est ce qui fait du bloc un tableau, et les deux-points qu'elle contient sont le seul moyen de régler l'alignement.
• Lignes de données — Une ligne par enregistrement. Une ligne comptant moins de cellules que l'en-tête est complétée ; une ligne en comptant plus serait tronquée par la plupart des moteurs de rendu, aussi les fichiers irréguliers sont-ils ramenés à la largeur de la ligne la plus large.

Les deux choses qui cassent un tableau

• Une barre verticale non échappée — Une barre verticale dans une cellule termine cette cellule trop tôt : la ligne gagne une colonne et le moteur de rendu décale ou perd les données. Cet outil échappe toujours toutes les barres verticales — ce n'est pas une option car il n'existe aucun cas où le caractère brut était ce que vous vouliez.
• Un saut de ligne dans une cellule — Une ligne de tableau Markdown tient sur une seule ligne. Un champ CSV entre guillemets contenant un saut de ligne — une adresse postale, un commentaire — terminerait la ligne au milieu et toutes les lignes suivantes tomberaient hors du tableau. Voir la section sur les sauts de ligne ci-dessous pour les trois façons dont l'outil traite cela.

L'alignement vit dans la ligne de séparation, sous forme de deux-points. Cet outil l'écrit pour vous, et il peut différer par colonne — ce que l'on veut dès qu'un tableau mêle des libellés et des nombres.

• Gauche — :--- — La valeur par défaut, et le bon choix pour les noms, les libellés et le texte libre. Un deux-points à gauche des tirets.
• Centre — :---: — Des deux-points de chaque côté. Utile pour les colonnes de statut courtes et les marques d'un seul caractère, où le centrage se lit mieux qu'un bord gauche irrégulier.
• Droite — ---: — Un deux-points à droite. C'est celui qui compte pour les nombres : des chiffres alignés à droite se calent sur la virgule décimale, si bien qu'une colonne de prix ou d'effectifs se compare d'un coup d'œil.
• Aucun — --- — Pas de deux-points du tout. Le moteur de rendu applique sa propre valeur par défaut, qui est la gauche dans tous ceux que nous connaissons, et la ligne de séparation reste la plus courte possible.
• Par colonne — L'en-tête de chaque colonne dans l'aperçu porte sa propre liste déroulante. Réglez la valeur par défaut une fois, puis passez les deux colonnes numériques à Droite : un tableau de noms et de chiffres se lit correctement en quatre clics environ.

Un texte venu d'un tableur ignore qu'il est sur le point de devenir du Markdown, et plusieurs caractères parfaitement ordinaires prennent alors un sens. L'outil sépare ce qu'il corrige toujours de ce que vous choisissez.

Toujours échappé

• Barres verticales — Écrites \| . Une barre verticale non échappée termine la cellule, ce qui décale ou perd des données — personne ne veut de cette version-là, donc ce n'est pas un interrupteur.
• Antislashs — Doublés en \\ , et traités en premier pour que les antislashs ajoutés par toutes les autres règles ne soient pas doublés à leur tour. Un chemin Windows dans une cellule ressort intact.

À votre choix

• Caractères Markdown — Astérisques, tirets bas, accents graves, crochets, chevrons et tildes. Une cellule contenant *note* est rendue en italique, astérisques disparus ; échappée, elle se lit *note*. Désactivé par défaut, car la plupart des tableaux n'en contiennent aucun et les antislashs se voient dans le fichier brut.
• Sauts de ligne : <br> — La valeur par défaut. Un saut dans une cellule devient un saut de ligne HTML, que tout moteur de rendu Markdown gérant les tableaux gère aussi, si bien qu'une adresse sur plusieurs lignes reste une seule cellule et reste lisible.
• Sauts de ligne : \n — Un antislash-n littéral. Le bon choix quand le tableau part vers un endroit qui supprime le HTML, et quand il importe qu'un saut ait existé sans être rendu comme tel.
• Sauts de ligne : espace — Le saut devient une simple espace. La sortie la plus courte, et le bon choix quand les sauts sont un artefact de l'export plutôt qu'un sens.
• Ce qui n'est pas échappé — Les traits d'union, les points et les signes plus sont laissés tels quels. Les échapper est techniquement valide et transforme chaque date en 2026\-01\-01 et chaque prix en 12\.50, dont aucun moteur de rendu n'a besoin et qu'aucun lecteur ne veut.

La moitié de ce qui rend un tableau converti faux se joue avant qu'un seul caractère Markdown soit écrit. Ces trois réglages décident de ce que sont les lignes, et tous trois sont détectés depuis le fichier avec une possibilité de forçage à côté.

• Délimiteur — Virgule, point-virgule, tabulation ou barre verticale, détecté en analysant un échantillon avec chaque candidat et en gardant celui qui produit les largeurs de ligne les plus régulières. Compter les séparateurs sur la première ligne — le raccourci habituel — lit "a,b,c,d";"e";"f" comme séparé par des virgules et écrase chaque ligne en une seule colonne.
• Caractère de guillemet — Guillemet double, apostrophe ou aucun, détecté de la même façon. Un guillemet n'ouvre un champ qu'en première position, si bien qu'une apostrophe dans O'Brien reste une apostrophe au lieu d'avaler le reste de la ligne.
• Encodage — Auto par défaut : la marque d'ordre des octets l'emporte quand le fichier en a une, sinon les octets sont testés comme UTF-8 valide et l'outil retombe sur Windows-1252. Forcez UTF-8, UTF-16LE, UTF-16BE, Windows-1252 ou ISO-8859-1 quand un fichier ne porte pas de marque et que la supposition se trompe.
• ISO-8859-1 n'est pas Windows-1252 — La plateforme web traite le premier comme un alias du second, si bien que la plupart des outils proposent les deux et n'en donnent qu'un. Ici, ISO-8859-1 est réellement du Latin-1 octet vers point de code, ce qui compte pour les fichiers où 0x80 à 0x9F sont des codes de contrôle et non des guillemets typographiques.
• Marques d'ordre des octets — L'export « CSV UTF-8 » d'Excel en écrit une, et un outil qui ne la retire pas place un caractère invisible en tête de l'intitulé de votre première colonne. Ici elle est retirée, et si elle contredit l'encodage que vous avez choisi l'outil le dit au lieu de vous contredire en silence.

Les deux produisent le même tableau rendu. La différence, c'est l'aspect du fichier brut, et celle que vous voulez dépend entièrement de qui le lit ainsi.

• Alignée — Chaque cellule est complétée pour que les barres verticales se superposent. Le Markdown brut se lit comme un tableau dans n'importe quel éditeur de texte, ce que l'on veut quand quelqu'un ouvrira le fichier .md plutôt qu'une page rendue.
• Compacte — Une espace de chaque côté de chaque cellule, rien de plus. La sortie est plus petite et — plus utile — une valeur qui change dans une ligne ne recalcule pas l'alignement de toutes les autres, si bien qu'un tableau régénéré et versionné dans git produit un diff d'une ligne au lieu d'un diff de fichier entier.
• Le remplissage suit l'alignement — Une colonne alignée à droite est complétée à gauche, une colonne centrée des deux côtés. Le texte brut se cale donc comme le fera le tableau rendu, ce qui est tout l'intérêt de le compléter.
• Lignes numérotées — Ajoute une colonne de tête qui compte les lignes du corps à partir de un. Utile pour désigner une ligne dans un commentaire de revue, et cela ne fait pas partie de vos données : c'est régénéré chaque fois que le tableau l'est.
• Première ligne ou colonne en gras — Entoure la première ligne du corps, ou la première colonne de chaque ligne du corps, de doubles astérisques. La ligne d'en-tête est déjà en gras au rendu, donc ces options s'appliquent délibérément au corps — remettre l'en-tête en gras serait un réglage qui ne fait rien.

Un export de 25 Mo — environ 225 000 lignes — se convertit en une seconde environ sur un ordinateur de bureau, dans un fil d'arrière-plan, de sorte que la page ne se fige jamais.

Les exports réels sont rarement un simple en-tête suivi de lignes. Quatre réglages traitent les parties qui ne devraient pas devenir des cellules de tableau.

• Sauter les lignes de tête — Supprime des lignes en haut avant toute autre chose. Les rapports et les exports de tableaux de bord portent souvent un titre, une date et une ligne vide au-dessus du véritable en-tête ; sautez-les et la ligne 1 devient l'en-tête qu'elle aurait dû être.
• Limiter les lignes — Plafonne le nombre de lignes de données écrites. Un README veut les vingt premières lignes d'un gros export, pas les quarante mille — et l'aperçu montre exactement ce qui sera produit.
• Supprimer les lignes vides — Supprime toute ligne dont toutes les cellules sont vides. Les exports de tableur en accumulent en bas, et chacune devient une ligne de cellules vides dans le tableau.
• Supprimer les colonnes vides — Supprime toute colonne sans données. Quand une ligne d'en-tête est utilisée, l'intitulé seul ne conserve pas la colonne — une colonne inutilisée mais nommée est précisément le cas pour lequel ce réglage existe, et son intitulé part avec elle.

Un fichier se convertit dans l'offre gratuite avec tous les réglages de mise en forme disponibles. En convertir beaucoup d'un coup est ce qu'ajoute l'offre Pro, et cela prend deux formes car ce sont deux travaux réellement différents.

• Un lot de fichiers — Mettez jusqu'à cinquante CSV en file, convertissez-les en une action et repartez avec un seul ZIP. Les noms de fichiers en double sont rendus uniques dans l'archive au lieu de s'écraser.
• Un document fusionné — La même file écrite dans un unique fichier Markdown, chaque tableau sous un titre repris de son nom de fichier. C'est la forme que l'on veut pour une page de documentation qui doit montrer quatre tableaux liés au même endroit.
• Les réglages s'appliquent à la file — Alignement, remplissage, échappement et le reste s'appliquent à chaque fichier du lot, si bien qu'un ensemble d'exports ressort cohérent. L'alignement par colonne reste par fichier, car les colonnes diffèrent.
• Tout se fait sur votre appareil — Un lot, c'est le même moteur exécuté plus de fois. Rien n'est envoyé, la file est bornée par votre propre mémoire et non par un serveur, et le plafond de taille de l'offre Pro est ce que votre appareil peut encaisser.

Le tableau que cet outil écrit est du Markdown façon GitHub, le dialecte sur lequel presque tout s'est aligné. Quelques destinations ont des particularités qu'il vaut mieux connaître avant de coller.

• GitHub et GitLab — README, tickets, descriptions de pull requests et wikis. Les deux-points d'alignement sont respectés, et <br> dans une cellule est rendu comme un saut de ligne.
• Obsidian et VS Code — Tous deux rendent les tableaux en aperçu et tous deux lisent le fichier brut en permanence, ce qui est précisément le cas visé par la sortie alignée.
• Notion — Coller un tableau Markdown crée un vrai tableau Notion. L'alignement n'est pas repris, donc les deux-points ne font pas de mal mais ne font rien non plus.
• Jira et Confluence — Le Jira moderne convertit un tableau Markdown collé. L'ancien Confluence utilise son propre balisage de tableaux : collez dans une macro Markdown plutôt que dans le corps de la page.
• Générateurs de sites statiques — Jekyll, Hugo, Docusaurus, MkDocs et Astro rendent tous les tableaux GFM dans les fichiers de contenu. La sortie compacte garde les diffs de source petits quand un tableau est régénéré depuis des données.

Les tableaux Markdown sont utilisés dans les README, la documentation et les sites statiques. Convertir un CSV en Markdown permet d'intégrer des données tabulaires dans du contenu Markdown, et les garde dans le même gestionnaire de versions que le code qu'elles documentent.

• Docs et README — Placez des tableaux dans la documentation sans taper une seule barre verticale, et sans une capture d'écran qui devient obsolète dès que les chiffres changent.
• Texte portable — Markdown garde les données lisibles dans les dépôts, les wikis et les générateurs statiques — et lisibles comme texte brut quand rien ne les rend.
• Relisible dans un diff — Un tableau stocké en texte montre ce qui a changé ligne par ligne dans une pull request. Un tableur joint au même commit ne montre rien.
• Aucune dépendance à installer — Le résultat est du texte. Il ne demande ni greffon, ni extension, ni environnement d'exécution là où il atterrit, ce qui n'est vrai ni d'une feuille intégrée ni d'une image de graphique.

• Délimiteur — Détection automatique par régularité, ou choisissez virgule, point-virgule, tabulation ou barre verticale.
• Caractère de guillemet — Détection automatique, guillemet double, apostrophe ou aucun.
• Encodage — Auto avec détection de la marque d'ordre des octets, UTF-8, UTF-16LE, UTF-16BE, Windows-1252 ou un véritable ISO-8859-1.
• Première ligne comme en-tête — Activé, la ligne 1 est l'en-tête ; désactivé, toutes les lignes sont des données et des libellés Col 1, Col 2 sont générés.
• Alignement — Gauche, centre, droite ou aucun pour le tableau, remplaçable par colonne depuis l'en-tête de l'aperçu.
• Sortie alignée — Alignez les colonnes dans le fichier brut, ou gardez-le compact pour des diffs plus petits.
• Échapper les caractères Markdown — Échappe astérisques, tirets bas, accents graves, crochets, chevrons et tildes en plus des barres verticales et antislashs toujours échappés.
• Sauts de ligne dans une cellule — Transformez un saut en <br>, en \n littéral ou en espace.
• Lignes numérotées, ligne et colonne en gras — Une colonne de comptage, une première ligne de données en gras et une première colonne en gras — indépendamment.
• Sauter, limiter et nettoyer — Supprimez des lignes de tête, plafonnez le nombre de lignes, et retirez les lignes et colonnes qui ne contiennent rien.
• Télécharger sous — Nom de fichier personnalisé pour le .md ; l'extension est ajoutée si vous l'omettez.

• CSV vers JSON
• CSV vers XML
• CSV vers Excel
• Outils CSV
• An OpenDocument spreadsheet

  Same typed columns and frozen header, for readers who use LibreOffice rather than Excel

• Cut it down first

  A README wants the rows that matter, not all forty thousand of them