Convertisseur de tableau Markdown vers CSV
Convertit un tableau Markdown (`| col1 | col2 |`) en CSV ou TSV. Pratique pour récupérer des tableaux exportés depuis GitHub Wiki, Notion ou Confluence vers Excel ou un tableur. La conversion s'effectue entièrement dans le navigateur ; aucune donnée n'est envoyée à un serveur.
| Délimiteur de sortie |
|
|---|---|
| Inclure la ligne d'en-tête dans la sortie |
Saisissez un tableau Markdown pour voir ici le CSV généré.
Correspondance entre une ligne de tableau Markdown et une ligne CSV
| Une ligne Markdown | | name | age | city | |
|---|---|
| Ligne CSV résultante | name,age,city |
La ligne de délimitation juste après l'en-tête (`---`, `:---`, `:---:` ou `---:`) est ignorée plutôt que traitée comme une donnée. Toute barre verticale échappée (`\|`) à l'intérieur d'une cellule est restaurée en caractère "|" normal.
Ce qu'est la conversion de tableau Markdown vers CSV
Les tableaux créés dans des outils de documentation comme GitHub Wiki, Notion ou Confluence sont agréables à lire, mais dès qu'il s'agit de calculer des totaux, de trier ou de filtrer, il faut les faire passer par un tableur. C'est précisément à cela que sert cet outil : il lit la syntaxe de tableau Markdown et la convertit en CSV ou en TSV, sans que vous ayez à retaper les colonnes à la main. La ligne de délimitation placée juste sous l'en-tête est détectée automatiquement et ignorée lors de l'export, car elle ne porte aucune donnée réelle — elle sert uniquement à la mise en forme visuelle du tableau.
La syntaxe prise en charge est celle de GitHub Flavored Markdown : aussi bien l'écriture classique avec des barres verticales en début et fin de ligne (`| a | b |`) que la variante plus compacte qui s'en passe. Si une cellule contient une virgule ou un guillemet double, elle est automatiquement entourée de guillemets selon les règles du format CSV, afin qu'aucune colonne ne se décale lors d'une relecture ultérieure. Si aucune ligne de délimitation n'est présente, le texte n'est pas reconnu comme un tableau et aucun résultat n'est produit — un signal utile indiquant qu'il manque quelque chose dans le texte source.
Comment convertir un tableau Markdown en CSV
- Coller le tableau Markdown Copiez la partie tableau de votre document et collez-la ici. Veillez à conserver la ligne de délimitation dans le texte collé.
- Choisir le format de sortie Optez pour un CSV séparé par des virgules ou un TSV séparé par des tabulations. Pour un collage direct dans un tableur, le TSV limite les risques de décalage de colonnes lorsque des virgules figurent dans les valeurs.
- Décider du sort de la ligne d'en-tête Si vous préférez gérer les titres de colonnes séparément, décochez « Inclure la ligne d'en-tête dans la sortie » pour n'obtenir que les lignes de données.
- Copier le résultat et le réutiliser Copiez le résultat directement dans votre tableur, ou enregistrez-le en fichier CSV pour l'importer plus tard.
Astuces pour en tirer le meilleur parti
- La ligne de délimitation juste après l'en-tête est détectée et ignorée automatiquement, donc `---`, `:---` (gauche), `:---:` (centre) et `---:` (droite) se convertissent tous sans problème, quel que soit l'alignement.
- Désactiver « Inclure la ligne d'en-tête dans la sortie » génère un CSV ne contenant que les lignes de données, sans l'en-tête — pratique si vous souhaitez gérer l'en-tête séparément.
- Si la valeur d'une cellule contient une virgule ou un guillemet double, elle est automatiquement entourée de guillemets doubles selon les règles CSV, tout `"` interne étant échappé en `""`.
- Associez cet outil au convertisseur de CSV vers tableau Markdown pour convertir entre CSV et tableaux Markdown autant de fois que nécessaire.
Cas d'usage de la conversion Markdown vers CSV
Exploiter des tableaux de documentation
Faites passer une liste tenue sur GitHub Wiki ou Notion vers un tableur pour la trier, la filtrer ou en calculer les totaux.
Traiter une liste de README comme une donnée
Convertissez un tableau de compatibilité ou une liste de configuration en CSV afin qu'un script puisse la lire pour des vérifications ou une génération automatique.
Extraire des tâches d'un compte-rendu de réunion
Transformez une liste de tâches rédigée sous forme de tableau Markdown en un format directement importable dans un outil de gestion de projet.
Faire des allers-retours entre les formats
En complément de l'outil jumeau qui convertit du CSV vers un tableau Markdown, vous pouvez convertir dans les deux sens autant de fois que nécessaire, quel que soit le format de départ.
Lexique Markdown et CSV
- Syntaxe de tableau
- L'écriture Markdown qui représente un tableau en alignant des cellules séparées par des barres verticales. Contrairement au CSV, elle comporte une ligne d'en-tête et une ligne de délimitation dédiée.
- Ligne de délimitation
- La ligne composée de tirets placée juste sous l'en-tête. Elle apparaît visuellement comme un trait de séparation, mais n'est pas une donnée et est ignorée lors de la conversion.
- GFM
- Abréviation de GitHub Flavored Markdown. Cette norme autorise, en plus de la notation classique, les tableaux sans barres verticales en début ou fin de ligne.
- TSV
- Un format où les valeurs sont séparées par une tabulation plutôt que par une virgule. Il convient bien aux données contenant des virgules et au collage direct dans un tableur.
- Mise entre guillemets
- L'action d'entourer une valeur de guillemets doubles selon les règles du CSV. Nécessaire dès que la valeur elle-même contient une virgule ou un guillemet.
Questions fréquentes
Anecdote — ce qui distingue vraiment un tableau Markdown d'un CSV
Le CSV et les tableaux Markdown sont tous deux des façons textuelles de représenter des données tabulaires, mais ils servent des objectifs différents. Le CSV est un format lisible par machine, destiné à être lu et écrit par des programmes — tableurs, bases de données et autres —, tandis qu'un tableau Markdown est une notation orientée documentation qui privilégie le fait qu'un humain puisse jeter un œil au code source et malgré tout distinguer approximativement la forme du tableau.
C'est pourquoi un tableau Markdown possède des concepts que le CSV n'a pas : une ligne d'en-tête et une ligne de délimitation (`---`). Visuellement, cette ligne de délimitation se rend comme un trait de séparation, mais dans le code source, ce n'est rien de plus qu'une suite de tirets — une notation propre à Markdown qui existe uniquement pour indiquer à l'analyseur que « tout ce qui précède est l'en-tête, tout ce qui suit est une donnée ».
Vouloir déplacer un tableau créé dans un outil de documentation comme GitHub Wiki, Notion ou Confluence vers un tableur est une situation qui se présente souvent lors du rangement de comptes-rendus de réunion d'équipe ou d'un README. Disposer de cet outil aux côtés de son homologue — de CSV vers tableau Markdown — permet de partir de l'un ou l'autre format et de convertir sans hésiter.