Le meilleur convertisseur CSV vers tableau Markdown en 2026 : toutes les options comparées

8 septembre 2026 · 33 min de lecture

Transformer un CSV en tableau Markdown ressemble à un travail de rechercher-remplacer. Mettez une barre verticale partout où il y a une virgule, ajoutez une ligne de tirets sous la première ligne, terminé. Cela fonctionne jusqu’au moment où cela ne fonctionne plus, et le fichier qui fait tout casser contient une virgule à l’intérieur d’un champ entre guillemets, ou une description de produit avec un retour à la ligne en plein milieu, ou une colonne de chemins de fichiers où figure une barre verticale — et le tableau qui en sort a le mauvais nombre de colonnes sur une ligne que vous ne remarquerez pas avant que quelqu’un d’autre ne la remarque.

En bref

Ce qui distingue les convertisseurs CSV vers Markdown, ce ne sont pas les fonctionnalités, c’est de savoir s’ils analysent du CSV ou s’ils découpent sur les virgules. Un outil qui suit la RFC 4180 encaisse les champs entre guillemets, les virgules à l’intérieur des guillemets, le guillemet doublé qui signifie un guillemet littéral, et les retours à la ligne dans une cellule ; un outil qui découpe sur les virgules massacre les quatre et ne vous en dit rien. La page /csv-to-markdown d’un convertisseur qui tourne dans le navigateur fait l’analyse chez vous, sans rien téléverser, et transforme un retour à la ligne intracellulaire en <br>, parce qu’un tableau Markdown ne peut pas en contenir un vrai. Pandoc et Miller lisent tous deux correctement le CSV et le TSV en ligne de commande ; pandas.to_markdown est le bon choix quand le tableau est la dernière ligne d’une analyse. Quoi que vous preniez, vérifiez une ligne contenant un guillemet avant de faire confiance au reste.

Pourquoi un CSV ne devient pas simplement un tableau

Un fichier CSV est un format texte doté d’une spécification, et cette spécification est assez courte pour se lire en dix minutes. La RFC 4180 dit que les champs sont séparés par des virgules, les enregistrements par des CRLF, et que tout champ peut être encadré de guillemets droits. Dès qu’un champ est entre guillemets, il peut contenir des virgules, il peut contenir des retours à la ligne, et un guillemet à l’intérieur s’écrit deux fois. C’est à peu près tout le document, et chaque règle y figure parce que les données de quelqu’un contenaient le séparateur.

La première question à poser à n’importe quel convertisseur CSV vers tableau Markdown est donc de savoir s’il applique ces règles ou s’il les approxime. L’approximation, c’est un split(','), et elle est partout : dans les one-liners de shell, dans la moitié des extraits de code du web, et dans plus d’outils qu’on ne voudrait. Elle donne le bon résultat sur des données propres, et c’est précisément ce qui la rend si difficile à repérer. Smith, John dans un champ entre guillemets devient deux cellules, la ligne est désormais plus large d’une cellule que l’en-tête, et selon l’écrivain qui se trouve à l’autre bout, cette cellule en trop est soit supprimée en silence, soit responsable d’un tableau déformé.

La deuxième question porte sur ce qui se passe à la sortie, car les tableaux Markdown ont leurs propres règles et elles sont plus strictes que celles du CSV. Une barre verticale termine une cellule où qu’elle apparaisse : une valeur qui en contient une doit donc être échappée. Une cellule ne peut contenir aucun retour à la ligne — le tableau est fondé sur les lignes, une ligne par enregistrement, sans syntaxe de continuation — un champ CSV contenant un paragraphe doit donc être aplati, sans quoi le tableau cesse d’être un tableau. Et un tableau Markdown sans ligne d’en-tête n’existe pas, parce que la ligne de tirets sous l’en-tête est précisément ce qui permet à un analyseur de reconnaître un tableau. Les tableaux ne figurent d’ailleurs pas dans le CommonMark nu, ce qui est un piège à part, traité dans l’article sur les variantes.

Troisièmement, il y a la question de savoir où va le fichier. Les feuilles de calcul sont les documents les plus sensibles que la plupart des gens convertissent : extractions de paie, listes de clients, exports de factures, résultats qui ne sont pas encore publiés. Un convertisseur en ligne qui téléverse est un convertisseur en ligne qui détient désormais vos lignes. C’est acceptable pour un tableau de licences open source et c’est un transfert de données pour tout le reste, raison pour laquelle la question vaut d’être posée avant de faire glisser le fichier sur la page.

Comparatif rapide : l’aide-mémoire

Les options CSV et TSV vers Markdown, une par une

TransformPipe — idéal pour un fichier que vous avez et un tableau qu’il vous faut maintenant

TransformPipe lit un fichier .csv ou .tsv dans votre navigateur et vous rend un tableau Markdown, sa première ligne servant d’en-tête. Il n’y a rien à installer et aucun compte n’est nécessaire, et si vous n’êtes pas connecté le fichier n’est envoyé nulle part — il est lu depuis votre disque par la page, analysé, puis réécrit sous forme de texte.

Prix : gratuit. Un compte ajoute l’historique, le partage et une API, gratuits eux aussi.

Détails techniques et fonctionnalités

• L’analyseur, ce sont les règles de la RFC 4180 et rien d’autre : un guillemet ouvre un champ, un guillemet doublé à l’intérieur est un guillemet littéral, et un retour à la ligne entre guillemets appartient à la cellule au lieu de terminer la ligne
• Le délimiteur est compté hors guillemets sur la première ligne parmi la virgule, la tabulation, le point-virgule et la barre verticale, et le plus fréquent l’emporte ; une extension .tsv impose la tabulation
• Une marque d’ordre des octets est retirée et les fins de ligne CRLF sont normalisées avant l’analyse : un fichier exporté depuis Excel sous Windows se comporte donc comme n’importe quel autre
• Les lignes courtes sont complétées par des cellules vides jusqu’à la largeur de la ligne la plus large, un fichier irrégulier produit donc quand même un tableau rectangulaire
• Le nom du fichier devient un titre de niveau 1 au-dessus du tableau, parce qu’un tableau sans titre est un tableau que personne ne saura situer une semaine plus tard
• La même conversion tourne depuis une API REST, une CLI sans dépendances qui déduit la conversion de l’extension du fichier, une GitHub Action et un serveur MCP

Pour qui ? Pour toute personne qui a un export de tableur et un document où le coller, en particulier si les lignes ne sont pas publiques. Toute la conversion se déroule sur votre machine, ce que vous pouvez confirmer en regardant l’onglet réseau ne rien faire pendant qu’elle s’exécute.

Pandoc — idéal quand le CSV n’est qu’une étape dans un document plus long

Pandoc est un convertisseur de documents en ligne de commande écrit en Haskell, et sa liste de formats d’entrée inclut csv (que le manuel décrit comme un tableau RFC 4180) et tsv. C’est donc le seul outil d’ici qui prend un CSV et vous rend du Markdown, du HTML, du LaTeX, du DOCX ou de l’EPUB avec la même commande et un -t différent.

Prix : gratuit, sous licence GPL.

Détails techniques et fonctionnalités

• pandoc -f csv -t markdown data.csv écrit un tableau à barres verticales ; -f tsv pour une entrée séparée par des tabulations (vérifié sur pandoc.org, le 8 septembre 2026)
• Le premier enregistrement du fichier est lu comme ligne d’en-tête, ce qui est l’hypothèse que font tous les autres outils d’ici
• La syntaxe de tableau Markdown obtenue dépend des extensions de tableau de l’écrivain — pipe_tables est celle qui correspond à GitHub, et un tableau de type grille ou simple ne s’affichera pas dans un analyseur GFM
• Le même fichier peut aller directement vers HTML, et --standalone l’emballe dans un document avec en-tête et styles au lieu de vous laisser un fragment

Pour qui ? Pour quiconque a un CSV parmi plusieurs entrées dans une chaîne qui exécute déjà Pandoc. Si la destination est une page web plutôt que du Markdown, y aller directement est en général le chemin le plus court — le comparatif des convertisseurs traite de ce qu’il faut prendre pour cette étape.

Miller — idéal pour remodeler les données au passage

Miller est un processeur en ligne de commande pour CSV, TSV, JSON et JSON Lines, écrit en Go, sans dépendances d’exécution. Markdown fait partie de ses formats de sortie : une conversion est donc une option plutôt qu’un script.

Prix : gratuit, open source, licence BSD à deux clauses (vérifié sur github.com/johnkerl/miller, le 8 septembre 2026).

Détails techniques et fonctionnalités

• --omd sélectionne la sortie Markdown, --imd l’entrée Markdown, et les raccourcis --c2m et --m2c font le CSV vers Markdown et le retour
• --omd-aligned complète les colonnes pour que la source du tableau reste lisible par un humain qui la retouchera ensuite
• --right-align-numeric émet ---: dans la ligne de séparation pour les colonnes numériques, ce qui est la syntaxe d’alignement que GFM comprend
• Comme la conversion est un format de sortie et non un mode, mlr --c2m sort -f region cut -f region,total data.csv filtre et convertit en une seule passe

Pour qui ? Pour quiconque veut un sous-ensemble du fichier plutôt que sa totalité : le dernier trimestre, trois colonnes sur onze, les lignes au-dessus d’un seuil. Le faire dans le convertisseur vaut mieux que tout convertir puis supprimer des lignes dans le Markdown ensuite.

csvlook, de csvkit — idéal pour lire le fichier avant de le convertir

csvkit est une suite d’outils en ligne de commande pour le CSV, écrite en Python. csvlook affiche un CSV dans le terminal dans ce que sa propre documentation appelle un format à largeur fixe compatible Markdown — un tableau que vous pouvez lire, et coller.

Prix : gratuit, sous licence MIT (vérifié sur github.com/wireservice/csvkit, le 8 septembre 2026).

Détails techniques et fonctionnalités

• csvlook data.csv affiche le tableau ; les tubes fonctionnent, csvcut -c 1,3 data.csv | csvlook le rétrécit donc d’abord
• --max-rows, --max-columns et --max-column-width limitent ce qui est affiché, et chacune de ces options modifie le tableau et pas seulement la vue
• --no-inference désactive la détection de types, ce qui compte pour des colonnes d’identifiants qui ressemblent à des nombres
• --snifflimit 0 désactive la détection du dialecte quand la supposition est mauvaise

Pour qui ? Pour les gens qui vivent dans un terminal et veulent voir le fichier avant de décider quoi que ce soit à son sujet. Prenez la sortie Markdown comme une commodité et non comme le but, et vérifiez les options de troncature avant de coller un tableau large.

csv2md — idéal pour une ligne dans un script, une fois que vous avez choisi lequel

Il n’existe pas un seul csv2md. Il existe plusieurs outils sans lien entre eux portant ce nom, dans des langages différents, avec des options différentes, et chercher l’un ramène les autres. Deux sont faciles à vérifier : un en Python installé avec pip, et un en Ruby installé sous forme de gem.

Prix : gratuit, sous licence MIT — pour l’implémentation Python comme pour celle en Ruby (vérifié sur github.com/lzakharov/csv2md et github.com/jonmagic/csv2md, le 8 septembre 2026).

Détails techniques et fonctionnalités

• L’outil Python (pip install csv2md) documente -d pour le délimiteur, -q pour le caractère de guillemet, -C pour sélectionner des colonnes, -c et -r pour l’alignement centré et à droite, et -H pour indiquer que le fichier n’a pas de ligne d’en-tête — auquel cas il génère des en-têtes façon tableur, a, b, c
• Cette option -H mérite d’être signalée : c’est le seul outil d’ici qui réponde à la question du fichier sans en-tête autrement que par « votre première ligne de données est désormais l’en-tête »
• L’outil Ruby (gem install csv2md) convertit un CSV en tableau GitHub Flavored Markdown et accepte -r pour aller dans l’autre sens

Pour qui ? Pour les scripts qui convertissent de façon répétée un fichier de forme connue. Figez le paquet exact dans vos instructions, car « installez csv2md » est un conseil ambigu.

tablesgenerator.com — idéal pour retoucher le tableau après l’import

Tables Generator est un outil de navigateur qui vous donne une grille façon tableur et en génère du balisage, dont du Markdown parmi plusieurs formats. Sa valeur n’est pas la conversion, ce sont les vingt minutes d’après, celles où vous réparez le tableau.

Prix : gratuit ; aucun compte ni paiement n’est mentionné sur la page (vérifié sur tablesgenerator.com, le 8 septembre 2026).

Détails techniques et fonctionnalités

• Import depuis le téléversement d’un fichier CSV, depuis un collage de Markdown ou de HTML, ou depuis une plage de tableur copiée
• Rechercher-remplacer, mise en forme des nombres, insertion et suppression de lignes et de colonnes, transposition, sauvegarde automatique locale
• La page annonce la prise en charge de la syntaxe de tableau de GitHub Flavored Markdown, qui est la variante sur laquelle la plupart des analyseurs s’accordent
• Copie vers le presse-papiers, ou téléchargement du résultat en CSV

Pour qui ? Pour quiconque assemble un tableau à la main à partir de plusieurs sources, ou corrige les titres et l’alignement d’un tableau converti avant de le publier. Ce n’est pas l’outil pour des lignes confidentielles, et pas davantage l’outil pour un fichier qui en compte dix mille.

Les extensions VS Code — idéales quand le fichier est déjà ouvert dans votre éditeur

Si le CSV est dans votre dépôt, le chemin le plus court passe par l’éditeur où il est déjà ouvert. Deux extensions couvrent les deux moitiés du travail : l’une colle une plage de tableur copiée sous forme de tableau Markdown, l’autre rend le CSV lui-même lisible.

Prix : gratuites (vérifié sur marketplace.visualstudio.com, le 8 septembre 2026).

Détails techniques et fonctionnalités

• Excel to Markdown table (csholmq) convertit une plage de tableur copiée dans le presse-papiers en tableau Markdown, depuis la palette de commandes ou avec Shift+Alt+V, et lit un préfixe ^l, ^c ou ^r sur un en-tête pour fixer l’alignement de cette colonne
• Rainbow CSV (mechatroner) colore les colonnes d’un CSV ou d’un TSV pour qu’un guillemet mal placé devienne visible sous forme de changement de couleur, propose l’alignement des colonnes et inclut une commande de copie au format Markdown
• La documentation de Rainbow CSV indique que son type de fichier Dynamic CSV gère les champs multilignes échappés entre guillemets, ce qui est précisément le cas RFC 4180 que la plupart des colorateurs traitent de travers
• Les deux travaillent sur le fichier tel qu’il est : aucune n’ajoute une étape de build

Pour qui ? Pour les développeurs qui écrivent de la documentation à côté des données. Associez-les — l’une pour vérifier le fichier, l’autre pour produire le tableau.

pandas.to_markdown — idéal quand le tableau est le point final d’une analyse

Si les lignes sont déjà passées par pandas, le tableau Markdown est à un appel de méthode. DataFrame.to_markdown() existe, et il exige que le paquet tabulate soit installé.

Prix : gratuit. pandas est sous licence BSD à 3 clauses ; tabulate, qu’il exige, est sous MIT.

Détails techniques et fonctionnalités

• pd.read_csv('data.csv').to_markdown(index=False) constitue toute la conversion, et index=False est la partie que les gens oublient (vérifié sur pandas.pydata.org, le 8 septembre 2026)
• Le paramètre index vaut True par défaut : la sortie par défaut embarque donc les numéros de ligne dans une colonne sans en-tête
• tablefmt est passé à tabulate, et la valeur par défaut documentée émet des deux-points d’alignement dans la ligne de séparation
• Tout ce que pandas fait à un CSV en entrée — inférence de types, na_values, thousands, un encoding explicite — se produit avant l’écriture du tableau, pour le meilleur et pour le pire

Pour qui ? Pour quiconque produit un tableau à partir de données qu’il calcule déjà : un rapport hebdomadaire, un résultat de notebook, un résumé qu’un script ajoute à la fin d’un fichier Markdown.

tabulate — idéal quand vous avez des lignes mais pas de DataFrame

tabulate est la bibliothèque que pandas appelle, et elle accepte une simple liste de listes. Si vos lignes viennent d’un curseur de base de données, d’une réponse JSON ou de csv.reader, c’est la plus petite des deux dépendances.

Prix : gratuit, sous licence MIT (vérifié sur pypi.org, le 8 septembre 2026).

Détails techniques et fonctionnalités

• tabulate(rows, headers=header, tablefmt='github') produit un tableau de style GFM ; tablefmt='pipe' ajoute des deux-points d’alignement dans la ligne de séparation (vérifié sur pypi.org, le 8 septembre 2026)
• Associez-la au module csv de la bibliothèque standard, qui implémente les règles de guillemets, plutôt qu’à line.split(',')
• La gestion de l’en-tête est explicite : vous passez headers vous-même, un fichier sans en-tête est donc votre décision et non celle de l’outil

Pour qui ? Pour les scripts Python qui détiennent déjà des lignes en mémoire et ont besoin d’un tableau à la fin. Prenez csv.reader pour l’entrée et tabulate pour la sortie, et vous avez évité les deux bugs de la version naïve.

Le copier-coller depuis un tableur — idéal pour une plage, pas pour un fichier

Copier des cellules depuis Excel, Numbers ou Google Sheets place dans le presse-papiers du texte séparé par des tabulations, pas du CSV. Cela compte : les tabulations n’apparaissent presque jamais à l’intérieur d’une valeur, découper dessus est donc bien plus sûr que découper sur des virgules. C’est pourquoi la voie du presse-papiers fonctionne aussi souvent qu’elle le fait.

Prix : gratuit.

Détails techniques et fonctionnalités

• Une plage copiée est du TSV : une voie de conversion .tsv ou une extension de collage la gère donc sans réglage de délimiteur
• Les cellules contenant des tabulations ou des retours à la ligne sont mises entre guillemets par le tableur au moment de la copie, ce qui signifie que les règles de guillemets s’appliquent toujours
• La mise en forme des nombres est une propriété d’affichage : une cellule affichant 1 234,00 € peut placer 1234 dans le presse-papiers, et une cellule affichant une valeur arrondie peut y placer la précision complète

Pour qui ? Pour quiconque convertit une partie d’une feuille une seule fois. Si la même plage doit être convertie chaque semaine, exportez le fichier et écrivez plutôt un script.

Un one-liner de shell — idéal pour un fichier que vous avez déjà lu

awk -F, '{...}' est le convertisseur CSV vers tableau Markdown le plus rapide à écrire et le plus facile à rater. C’est un choix légitime pour exactement une situation : un fichier que vous avez ouvert, regardé, et dont vous savez qu’il ne contient ni guillemets, ni délimiteurs internes, ni retours à la ligne dans les cellules.

Prix : gratuit.

Pour qui ? Pour quelqu’un qui convertit une sortie qu’il a produite lui-même, dans un script qui sera supprimé ensuite. Pour tout ce qui vient d’un tableur, d’un export de base de données ou d’une autre personne, prenez un outil doté d’un analyseur. Le coût du one-liner n’est pas qu’il casse ; c’est qu’il casse une ligne au milieu de cent.

Une fenêtre de chat avec un assistant — idéale pour une poignée de lignes que vous pouvez vérifier

Coller des lignes dans un assistant et demander un tableau Markdown fonctionne, et c’est la seule option d’ici qui rangera aussi vos titres. Le hic, c’est qu’elle génère du texte au lieu de le transformer : la sortie n’est donc pas garantie de contenir les mêmes valeurs que l’entrée.

Prix : variable selon l’assistant.

Pour qui ? Pour quiconque a vingt lignes et l’œil sur toutes. Pour un export de paie, prenez un analyseur ; pour une liste griffonnée de trois colonnes, c’est plus rapide que tout ce qui précède. Faire passer un résultat vérifié d’un assistant à une page est un petit exercice à part entière.

Ce que la RFC 4180 fait à un convertisseur

C’est la section que la page d’un outil omet, parce que chaque point qui y figure est une façon d’échouer sans bruit. Prenez un fichier représentatif — un vrai, avec les lignes ingrates encore dedans — et vérifiez chacun de ces points avant de vous engager sur quoi que ce soit.

Une virgule dans un champ entre guillemets. "Smith, John",Sales,2026 fait trois champs, pas quatre. Un analyseur lit les guillemets et conserve la virgule ; un découpage produit quatre cellules, et une ligne plus large d’une cellule que l’en-tête. La règle de GFM veut que les cellules excédant le compte de l’en-tête soient écartées : Sales et 2026 glissent donc vers la gauche et la dernière valeur disparaît. Rien ne vous prévient. La ligne dit simplement autre chose que le fichier.

Un guillemet doublé vaut un guillemet. À l’intérieur d’un champ entre guillemets, "" signifie un " littéral. Ainsi "She said ""no""." est un seul champ qui se lit : She said "no". Un outil qui retire les guillemets à coups d’expression régulière laisse les doublés en place, et vous obtenez She said ""no"" dans votre tableau. C’est cosmétique jusqu’à ce que la valeur soit un exemple de code ou une mesure en pouces, moment où c’est faux.

Un retour à la ligne dans une cellule. C’est le cas sans réponse propre. La RFC 4180 autorise un retour à la ligne à l’intérieur d’un champ entre guillemets, et les tableurs en produisent constamment — blocs d’adresse, colonnes de notes, tout ce dans quoi une personne a tapé Alt+Entrée. Un tableau Markdown n’a aucun moyen de le représenter : le tableau est d’une ligne par enregistrement, et un retour à la ligne dans une cellule termine la ligne. Chaque outil doit choisir son mensonge. Supprimer le retour accole deux phrases. Scinder la ligne fabrique une seconde ligne, mal formée. Remplacer le retour par <br> conserve la coupure visible quand le Markdown est rendu en HTML, et laisse une balise HTML dans un fichier qui ne sera peut-être jamais rendu en HTML. TransformPipe remplace par <br>, au motif qu’une balise visible vaut mieux qu’un tableau silencieusement cassé — mais c’est un arbitrage, et ce que Markdown fait des retours à la ligne en général explique pourquoi il n’existe pas de meilleure option à l’intérieur d’un tableau.

Une barre verticale dans une valeur. Le CSV se moque des barres verticales ; Markdown y tient énormément. Un | non échappé termine la cellule où qu’il apparaisse, y compris entre accents graves : une seule valeur contenant a|b ajoute donc une colonne fantôme à cette ligne. Elle doit être échappée en \| à la sortie. C’est la défaillance sur laquelle trébuchent les convertisseurs écrits par des gens qui ont testé avec des noms et des nombres : elle se manifeste dans les chemins de fichiers, les expressions régulières, les commandes de shell et toute colonne contenant une liste d’options. Si vous convertissez des données de ce genre, mettez délibérément une barre verticale dans une cellule de test et regardez ce qui en sort. L’article sur les tableaux traite de ce que fait cet échappement de l’autre côté.

Un fichier sans ligne d’en-tête. Les CSV générés par une machine n’en ont souvent aucune — un export de journal, un extrait de base de données, un flux de capteurs. Un tableau Markdown ne peut pas exister sans en-tête, parce que la ligne de séparation en dessous est ce qui identifie le tableau pour l’analyseur. Chaque convertisseur fait donc l’une de ces trois choses : promouvoir votre première ligne de données en en-tête, ce qui perd le sens de cette ligne ; générer des titres de remplacement du genre a, b, c ou Colonne 1 ; ou refuser. La plupart prennent la première option sans rien dire, et c’est pourquoi un fichier de journal converti a si souvent un horodatage là où devraient figurer les noms de colonnes. Si votre fichier n’a pas d’en-tête, ajoutez-en un avant de convertir. C’est une ligne, et c’est la seule version de cette histoire qui finit bien.

Le délimiteur n’est pas toujours une virgule. Un CSV exporté dans une région où la virgule sert de séparateur décimal est très souvent délimité par des points-virgules, et il se termine quand même par .csv. Les fichiers séparés par des tabulations sont le même format de fichier avec un séparateur différent. Un convertisseur qui suppose la virgule transforme chaque ligne en une cellule unique contenant tout — un échec visible, au moins, ce qui est plus que ce qu’offrent les autres. Cherchez une option de délimiteur, ou un outil qui devine à partir de la première ligne.

Les octets qui précèdent le premier champ. Un fichier enregistré depuis Excel sous Windows peut commencer par une marque d’ordre des octets et utiliser des fins de ligne CRLF. La BOM se colle à votre premier titre de colonne, où elle est invisible dans l’éditeur et casse toute comparaison portant sur ce titre. Le CRLF laisse un retour chariot égaré à la fin de chaque dernier champ. Les deux sont triviaux à traiter pour un convertisseur, et ni l’un ni l’autre n’est traité par un découpage naïf.

Des lignes qui n’ont pas toutes la même longueur. Les vrais exports ont des lignes irrégulières. La largeur d’un tableau Markdown est fixée par l’en-tête, et les lignes du corps sont complétées ou tronquées pour s’y conformer, sans le moindre commentaire. Compléter une ligne courte est presque toujours la bonne chose à faire. Tronquer une ligne longue jette des données, et la ligne qui se fait tronquer est en général celle qui a le problème de guillemets — une ligne irrégulière vaut donc mieux d’être examinée que complétée.

Là où un tableau Markdown ne peut tout simplement pas aller

Une partie de ce que contient un tableur n’a aucun équivalent en Markdown, et savoir de quelles parties il s’agit vous évite de chercher un convertisseur qui les gérerait. Aucun ne le fait.

Les cellules fusionnées. Il n’y a ni colspan ni rowspan dans un tableau Markdown. Un en-tête fusionné couvrant trois colonnes doit devenir un titre dans une colonne, les deux autres restant vides, ou trois titres répétés. Si la source s’appuie sur des cellules fusionnées pour sa structure, le tableau est à repenser plutôt qu’à convertir.

Les formules et les formats de nombres. Un export CSV contient des valeurs, pas des formules — cette perte a lieu avant que le convertisseur ne voie le fichier. Il en va de même pour la mise en forme des nombres : symboles monétaires, séparateurs de milliers, pourcentages et formats de date sont des propriétés d’affichage du tableur, et ce qui atterrit dans le CSV est ce que l’exportateur a choisi d’écrire. Si le tableau converti affiche 0.4567 là où la feuille affichait 45,67 %, c’est l’export qui l’a fait, pas la conversion.

Les tableaux très larges. Les tableaux Markdown ne passent pas à la ligne et ne défilent pas d’eux-mêmes. Douze colonnes de prose s’affichent en un tableau plus large que la page, et ce qui se passe ensuite dépend de ce qui l’affiche — débordement horizontal, écrasement, ou barre de défilement si le HTML environnant en fournit une. Coupez des colonnes avant de convertir, ou acceptez que le tableau ne se lise que sur un grand écran.

Le tri, le filtrage et les totaux. Un tableau Markdown, c’est du texte. Il n’a ni tri, ni filtre, ni ligne de totaux qui recalcule. Si le lecteur doit interroger les nombres, le tableau est la mauvaise sortie et un lien vers le CSV est la bonne. Les tableaux Markdown sont faits pour des données assez petites et assez figées pour se lire.

Comment choisir

1. Vérifiez une ligne difficile avant toute chose. Trouvez dans votre fichier une valeur contenant un guillemet, une virgule entre guillemets ou un retour à la ligne, convertissez ce fichier, et regardez cette ligne dans la sortie. Si elle survit, l’outil a un analyseur ; sinon, aucune autre fonctionnalité ne compte, parce que l’échec est silencieux et que le fichier est désormais subtilement faux.
2. Décidez si les lignes ont le droit de quitter la machine. Pour un tableau de données publiques, la question ne se pose pas. Pour tout ce qui contient des noms, des salaires ou des chiffres non publiés, la conversion côté navigateur et un outil local en ligne de commande sont les deux seules options, et la différence ne se voit pas dans un comparatif de fonctionnalités.
3. Comptez combien de fois vous ferez cela. Une fois, c’est un dépôt de fichier. Chaque semaine, c’est un script, et un script plaide pour Pandoc, Miller ou un appel de bibliothèque, parce qu’un humain qui pilote un onglet de navigateur est la partie d’un processus hebdomadaire qui finit par être oubliée.
4. Demandez-vous si vous voulez toutes les lignes. Si la réponse est non, convertissez avec quelque chose qui sait aussi filtrer. Supprimer des lignes d’un tableau Markdown à la main est la manière la plus lente qui soit, et c’est de là que viennent les erreurs de recopie.
5. Regardez si votre fichier a un en-tête, avant que l’outil ne décide à votre place. S’il n’en a pas, ajoutez-en un. Toutes les réponses d’un convertisseur à un fichier sans en-tête perdent quelque chose, et la version où c’est vous qui fournissez les noms de colonnes est la seule qui produise un tableau que quelqu’un pourra lire plus tard.

Conclusion

Le meilleur convertisseur CSV vers tableau Markdown est celui qui lit le fichier comme du CSV et non comme du texte avec des virgules dedans — le guide pratique liste chaque piège par symptôme — parce que tout le reste de ce travail est facile et que cette partie-là est la seule qui échoue sans le dire. Pour un fichier sur votre disque et un document où le coller, la conversion CSV vers tableau Markdown du convertisseur de navigateur évoqué plus haut fait l’analyse RFC 4180 chez vous, échappe les barres verticales, transforme les retours à la ligne intracellulaires en <br> et ne téléverse rien — gratuitement, sans installation. Pour un travail qui se répète, mettez Miller ou Pandoc dans le script. Pour un tableau à la fin d’une analyse que vous exécutez déjà en Python, to_markdown était là depuis le début. Quel que soit votre choix, gardez comme test un fichier contenant une virgule entre guillemets et un retour à la ligne interne, et faites-le passer dans tout nouvel outil avant de lui confier de vraies lignes.

FAQ

Comment convertir un CSV en tableau Markdown sans téléverser le fichier ?

Prenez un convertisseur qui tourne dans le navigateur ou un qui tourne sur votre propre machine. Un outil côté navigateur lit le fichier avec l’API de fichiers de la page elle-même et ne l’envoie jamais, ce que vous pouvez vérifier en ouvrant l’onglet réseau et en regardant qu’il ne se passe rien ; un outil en ligne de commande comme Miller ou Pandoc ne touche pas du tout au réseau.

Qu’arrive-t-il aux virgules à l’intérieur des champs entre guillemets ?

Dans un outil doté d’un vrai analyseur CSV, rien — les guillemets sont lus, la virgule reste dans la cellule, et la ligne conserve son nombre de colonnes. Dans un outil qui découpe sur les virgules, le champ devient deux cellules et la ligne gagne une colonne, et comme Markdown écarte les cellules au-delà du compte de l’en-tête, la valeur en fin de ligne disparaît sans le moindre avertissement.

Une cellule de tableau Markdown peut-elle contenir un retour à la ligne ?

Non. Un tableau Markdown est fondé sur les lignes, une ligne par enregistrement, sans syntaxe de continuation : un vrai retour à la ligne dans une cellule termine donc la ligne. Les convertisseurs traitent un champ CSV contenant un retour à la ligne en le remplaçant par <br>, qui s’affiche comme une coupure une fois le Markdown devenu du HTML, ou en l’aplatissant en une espace — et le choix appartient au convertisseur, vérifiez donc lequel le vôtre a fait.

Que font les convertisseurs d’un CSV sans ligne d’en-tête ?

La plupart promeuvent la première ligne de données en en-tête, car un tableau Markdown ne peut pas exister sans. Certains outils proposent une option qui génère des noms de remplacement à la place — le csv2md en Python documente -H pour exactement cela. La réponse fiable consiste à ajouter vous-même une ligne d’en-tête au fichier avant de convertir.

Comment convertir un fichier TSV plutôt qu’un CSV ?

Tout outil doté d’une option de délimiteur accepte une tabulation ; plusieurs la détectent depuis l’extension du fichier. Pandoc a un lecteur tsv distinct, Miller lit nativement le TSV, et un convertisseur qui devine le délimiteur à partir de la première ligne s’en sort sans qu’on le lui dise. Les données copiées depuis un tableur sont déjà séparées par des tabulations, ce qui explique pourquoi le collage fonctionne souvent mieux que l’export.

Un tableau Markdown conserve-t-il l’alignement des colonnes du tableur ?

Non, et il n’a aucune notion d’alignement au-delà de trois possibilités par colonne, fixées par des deux-points dans la ligne de séparation. Certains outils émettent ces deux-points — le format pipe de tabulate le fait, son format github non — et d’autres laissent chaque colonne alignée à gauche pour que vous la modifiiez. L’alignement au niveau de la cellule, les cellules fusionnées et la mise en forme des nombres n’existent tout simplement pas en Markdown.

Convertir Excel en Markdown, est-ce le même travail que convertir un CSV ?

Presque. Enregistrez la feuille en CSV et c’est le même travail, avec les mêmes règles de guillemets. Copiez plutôt une plage dans le presse-papiers et vous obtenez du texte séparé par des tabulations, plus facile à découper sans risque puisque les tabulations apparaissent rarement à l’intérieur des valeurs — mais les formules sont déjà devenues des valeurs et la mise en forme des cellules a déjà été écartée au moment où l’un ou l’autre format est produit.