Convertisseur CSV vers tableau Markdown
Convertit des fichiers CSV en syntaxe de tableau Markdown (`| col1 | col2 |`). Vous pouvez choisir le délimiteur, si la première ligne sert d'en-tête, et l'alignement des colonnes (gauche, centre, droite). Le résultat peut être copié ou téléchargé. La conversion s'effectue entièrement dans votre navigateur ; aucune donnée n'est envoyée à un serveur.
| Délimiteur |
|
|---|---|
| Utiliser la première ligne comme en-tête | |
| Alignement des colonnes |
|
Saisissez des données CSV pour voir ici le tableau Markdown généré.
Comment une ligne CSV se transforme en tableau Markdown
| Une ligne de CSV | name,age,city |
|---|---|
| Syntaxe Markdown obtenue | | name | age | city | |
Lorsque la première ligne est utilisée comme en-tête, elle devient la ligne d'en-tête, suivie d'une ligne de séparation (---) indiquant l'alignement, puis chaque ligne suivante devient une ligne de données.
Qu'est-ce qu'un convertisseur de CSV vers tableau Markdown
Un tableau Markdown est entièrement dessiné avec des barres verticales et des tirets, ce qui le rend parfaitement lisible en texte brut, mais fastidieux à taper à la main dès qu'il y a plus de deux ou trois colonnes. Si les données source existent déjà au format CSV — exportées d'un tableur, issues d'une requête en base de données ou d'un fichier de log — il n'y a aucune raison de les ressaisir cellule par cellule. Cet outil lit le CSV et le reconstruit sous forme de véritable tableau Markdown : une ligne d'en-tête, une ligne de séparation qui marque l'alignement des colonnes, puis une ligne de données pour chaque ligne d'entrée.
Comme une ligne de tableau Markdown doit tenir sur une seule ligne physique, quelques transformations s'appliquent automatiquement au passage. Les barres verticales présentes dans une cellule sont échappées pour ne pas être confondues avec une limite de colonne, et les sauts de ligne à l'intérieur de cellules multilignes entre guillemets sont réduits à une seule espace. Vous pouvez aussi choisir un alignement à gauche, au centre ou à droite pour les colonnes, ce qui insère le motif de deux-points et de tirets correspondant dans la ligne de séparation. Tout se déroule localement dans votre navigateur, si bien que le CSV que vous collez ne quitte jamais votre machine.
Comment générer un tableau Markdown à partir d'un CSV
- Collez vos données CSV Collez le texte CSV dans le champ de saisie. Si vous l'avez copié directement depuis un tableur, passez le délimiteur en tabulation plutôt qu'en virgule.
- Décidez si la première ligne est un en-tête Si la première ligne contient les noms de colonnes, activez « Utiliser la première ligne comme en-tête » : la ligne de séparation sera insérée automatiquement juste en dessous.
- Choisissez un alignement de colonnes Les colonnes numériques se lisent généralement mieux alignées à droite. En laissant l'alignement sur « Aucun », le moteur de rendu Markdown applique son propre comportement par défaut.
- Copiez le résultat dans votre document Copiez le Markdown généré et collez-le dans un README, un issue, la description d'une pull request ou un article technique.
Astuces pour en tirer le meilleur parti
- Tout caractère barre verticale (|) présent dans une cellule est automatiquement échappé en \| afin de ne pas être confondu avec un séparateur de colonnes.
- Les sauts de ligne à l'intérieur de cellules multilignes entre guillemets sont remplacés par une espace, car une ligne de tableau Markdown doit tenir sur une seule ligne physique.
- En choisissant l'alignement « Gauche », « Centre » ou « Droite », `:---`, `:---:` ou `---:` est inséré dans la ligne de séparation, afin que des moteurs de rendu comme GitHub affichent les colonnes avec l'alignement voulu.
- Combinez cet outil avec les outils jumeaux CSV vers JSON et CSV vers SQL pour convertir un même CSV vers le format de sortie dont vous avez besoin.
Dans quels cas un convertisseur CSV vers Markdown est utile
Des tableaux dans un README
Organisez d'abord une matrice de compatibilité ou une liste d'options de configuration dans un tableur, puis convertissez-la : vous obtenez un tableau Markdown propre sans vous battre avec la largeur des colonnes à la main.
Des comparaisons dans les issues et les pull requests
Transformez des résultats de benchmark ou une liste de candidats en tableau sur-le-champ. Comme il s'agit toujours de texte brut, il reste lisible dans un diff.
Préparer des données pour un article technique
Des données de mesure peuvent directement devenir un tableau dans un article. Aligner les colonnes numériques à droite garde les chiffres bien rangés et faciles à comparer.
Mettre en ordre des comptes rendus et de la documentation
Utile pour faire migrer une liste jusque-là tenue dans un tableur vers une documentation maintenue en Markdown.
Vocabulaire des tableaux Markdown
- Syntaxe de tableau
- La notation Markdown consistant à disposer un tableau sous forme de cellules séparées par des barres verticales. Elle ne faisait pas partie de la spécification d'origine et a été ajoutée plus tard comme extension.
- Ligne de séparation
- La ligne de tirets placée juste sous la ligne d'en-tête. Elle indique à l'analyseur où s'arrête l'en-tête et où commencent les données.
- Marqueur d'alignement
- Un deux-points ajouté à côté des tirets de la ligne de séparation pour indiquer un alignement à gauche, au centre ou à droite sur cette colonne.
- GFM
- Abréviation de GitHub Flavored Markdown, une spécification étendue définie par GitHub, devenue le standard de facto pour la syntaxe de tableau.
- Échappement
- Le fait de faire précéder d'un antislash une barre verticale présente dans une cellule pour qu'elle ne soit pas confondue avec un séparateur de colonnes.
Questions fréquentes
Anecdote — Pourquoi les tableaux Markdown ne nécessitent que des barres verticales et des tirets
Markdown a été conçu en 2004 par John Gruber et Aaron Swartz comme un langage de balisage léger reposant sur l'idée que du texte brut doit rester compréhensible tel quel. La syntaxe de tableau ne fait pas exception : puisque les lignes sont tracées uniquement avec des barres verticales et des tirets, il n'est pas nécessaire d'ouvrir et de fermer des balises comme le <table> HTML, et la forme du tableau est reconnaissable rien qu'en regardant la source non rendue.
La syntaxe de tableau n'a jamais fait partie de la spécification originale de Markdown de John Gruber ; elle a été ajoutée plus tard comme extension par PHP Markdown Extra puis, de manière plus influente, par GitHub Flavored Markdown (GFM). C'est pourquoi de subtiles différences de comportement subsistent entre les implémentations (par exemple la gestion d'un nombre de colonnes incohérent), et la plupart des grandes plateformes — GitHub, GitLab et autres — suivent globalement le GFM.
Le besoin de coller directement dans la documentation le résultat d'un tableur ou d'une base de données survient constamment lors de la rédaction de README, d'issues et d'articles techniques. Taper à la main les barres verticales et les lignes de séparation est fastidieux, si bien qu'un convertisseur CSV en un clic est devenu une étape de préparation courante pour les développeurs qui rédigent leur documentation en Markdown.