Convertisseur CSV en Markdown

Les README, les descriptions de pull request et les sites de documentation affichent les tables Markdown à merveille, à condition que vous acceptiez d’écrire à la main les barres verticales et les tirets. Ce convertisseur lit un CSV, prend la première ligne comme en-tête et produit une table Markdown GitHub Flavored avec la bonne ligne de séparation. Chaque cellule est entourée des délimiteurs |, prête à être collée dans un README ou une description de pull request.

Comment la table est construite

  1. 1

    Collez le CSV

    Par défaut, un échantillon à trois colonnes ; remplacez-le par vos propres données.

  2. 2

    Choisissez le délimiteur

    Virgule par défaut. Choisissez tabulation, point-virgule ou barre verticale dans la liste selon vos données.

  3. 3

    La ligne 1 est l'en-tête

    La première ligne est émise comme l'en-tête Markdown, suivie de la ligne de séparateur requise `| --- | --- |`.

  4. 4

    Lignes remplies à la largeur

    Si une ligne de données a moins de cellules que l'en-tête, le convertisseur remplit avec des chaînes vides pour garder la table rectangulaire.

Rendu, alignement et où cela fonctionnera ou non

Les tables Markdown GitHub Flavored (GFM) sont largement supportées mais pas universelles. Savoir où elles s’affichent fait la différence entre un README net et un mur de pipes.

Supporté dans

  • Pull requests et wikis GitHub, GitLab, Bitbucket
  • La plupart des générateurs de sites statiques (Docusaurus, VitePress, MkDocs Material)
  • Aperçu Markdown de VS Code
  • Notion (via coller-en-markdown)

Non supporté dans

  • CommonMark sans l’extension GFM
  • Reddit (utilise son propre sous-ensemble)
  • Certains moteurs de wiki anciens (DokuWiki, MoinMoin)

Alignement des colonnes

Les tables GFM supportent l’alignement à gauche, au centre et à droite via des deux-points dans la ligne de séparateur. Ce convertisseur émet des séparateurs --- simples ; si vous avez besoin d’alignement, post-traitez :

Syntaxe Effet
:--- Aligné à gauche
:---: Aligné au centre
---: Aligné à droite

Remplacez la ligne de séparateur par | :--- | :---: | ---: | correspondant aux colonnes que vous souhaitez incliner.

Caractères de citation dans les cellules Markdown

  • Les caractères pipe (|) à l’intérieur d’une cellule doivent être échappés en tant que \\| pour éviter de diviser la cellule. Le convertisseur ne les échappe pas automatiquement, donc nettoyez à l’avance si vos données contiennent des pipes.
  • Les nouvelles lignes à l’intérieur d’une cellule interrompent le rendu GFM. Remplacez-les par <br> avant la conversion si vous souhaitez des sauts de ligne doux à l’intérieur d’une cellule.
  • Les astérisques, soulignés et backticks passent ; ils sont interprétés comme une emphase Markdown ou du code. Échappez-les avec un backslash en tête si vous les voulez littéraux.

Questions fréquentes

Pas par défaut : la ligne de séparation est simplement ---. Remplacez-la par :---, :---: ou ---: après conversion pour caler la colonne à gauche, au centre ou à droite.

Échappez-les avec un backslash avant la conversion, transformant | en \|. Sinon, le moteur de rendu Markdown les traite comme des séparateurs de colonnes et casse la table.

Les tables GFM s’affichent sur GitHub, GitLab, la plupart des générateurs de sites statiques et VS Code. Elles ne s’affichent pas sur du CommonMark pur, Reddit ou certains wikis anciens sans plugin.

Oui, le CSV est envoyé à notre serveur pour que le convertisseur puisse construire la table. Il n’est pas stocké et n’est pas ajouté au lien de la page.

Outils similaires

Outil disponible dans d’autres langues