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.
Astuces
- 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.
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.