CSV vers tableau Markdown

Comment ça marche

La première ligne est prise comme en-tête du tableau ; la ligne d'alignement propre à Markdown est ajoutée juste dessous, et les lignes restantes deviennent les données. En détection automatique, les candidats point-virgule, virgule, tabulation et barre verticale sont comptés hors guillemets, puis celui qui donne le même nombre de colonnes d'une ligne à l'autre est retenu — ainsi la virgule à l'intérieur d'un champ d'adresse n'est pas prise pour un séparateur. Les trois fins de ligne sont lues également : le CR+LF de Windows, le LF de macOS et de Linux, et le CR isolé des programmes très anciens, que beaucoup d'outils prennent pour une seule longue ligne. La barre verticale présente dans une cellule est échappée par une barre oblique inverse, car en Markdown ce caractère coupe la colonne. Le saut de ligne d'une cellule multiligne entre guillemets est remplacé par une balise <br> : dans un tableau Markdown, une cellule doit tenir sur une seule ligne. Les cellules de la sortie sont complétées d'espaces selon la largeur de chaque colonne, si bien que le tableau reste lisible même en texte brut, avant tout rendu.

Cet outil est aussi connu sous le nom de csv en markdown, csv to markdown, tableau markdown en ligne, markdown table generator, tableau pour readme.

Qu'est-ce que Markdown ?

Markdown est un langage d'écriture léger qui exprime la mise en forme avec des signes de ponctuation plutôt qu'avec des balises : un dièse en début de ligne fait un titre, un texte entre astérisques passe en gras, une ligne commençant par un tiret devient un élément de liste. Comme le fichier source reste lisible même sans être rendu, il est devenu le standard des dépôts de code, de la documentation et des applications de notes. L'extension du fichier est .md, et comme c'est du texte brut, il se marie bien avec le suivi de versions.

Qu'est-ce que Tableau Markdown ?

Un tableau Markdown se compose de lignes dont les cellules sont séparées par des barres verticales, avec, juste sous l'en-tête, une ligne d'alignement faite de tirets. Cette deuxième ligne est obligatoire : elle annonce le début du tableau et indique, avec des deux-points, si les colonnes s'alignent à gauche, au centre ou à droite. Une cellule ne peut contenir ni tableau, ni liste, ni saut de ligne ; c'est le prix de la portabilité.

Qu'est-ce que Ligne d'alignement ?

La ligne d'alignement est la ligne de tirets placée sous l'en-tête du tableau, écrite colonne par colonne. La position du deux-points détermine l'alignement : à gauche des tirets, la colonne s'aligne à gauche ; à droite, elle s'aligne à droite ; des deux côtés, elle se centre ; sans deux-points, c'est le réglage par défaut du moteur de rendu qui s'applique. Le nombre de cellules de cette ligne doit être identique à celui de l'en-tête, sans quoi le tableau n'est pas reconnu comme tel.

Quelle est la différence entre un CSV et un tableau Markdown ?

Le CSV a été conçu pour être lu par des machines : à part le caractère séparateur, aucun ornement, et aucune notion de largeur de colonne ni d'alignement. Le tableau Markdown a été conçu pour être lu par des humains ; il porte l'information d'alignement et ressemble à un tableau même à l'état de source. En revanche, un tableau Markdown ne s'importe pas dans une base de données. Cet outil transforme le CSV en tableau prêt à publier ; pour le chemin inverse, il faut retransformer le tableau en données.

Quel alignement choisir ?

En Markdown, l'alignement s'indique avec des deux-points sur la ligne de tirets sous l'en-tête, et il vaut pour tout le tableau. Cet outil applique un seul alignement ; pour aligner chaque colonne différemment, il suffit de retoucher à la main la ligne de tirets dans la sortie.

En pratique, dans les tableaux de montants, de quantités et de dates, l'alignement à droite facilite nettement la lecture : les chiffres tombent les uns sous les autres. Pour les tableaux surtout textuels, la gauche est la position naturelle.

• À gauche — colonnes de texte : nom, description, statut
• Centré — étiquettes courtes, symboles, codes d'une lettre
• À droite — montant, quantité, pourcentage, date

Où utiliser la sortie ?

Les tableaux Markdown sont rendus de la même façon dans les dépôts GitHub et GitLab, les fichiers README, les pages de wiki, les générateurs de sites statiques et bien des applications de prise de notes.

Vous pouvez continuer à modifier le tableau après l'avoir collé dans un document : pour ajouter une ligne, écrivez une nouvelle ligne avec le même nombre de barres verticales. Même si les espaces de remplissage se décalent, le tableau reste rendu correctement ; ils ne servent qu'à la lisibilité.

À quoi faire attention dans vos données ?

La ligne d'en-tête est obligatoire. Si vos données n'en ont pas, ajoutez une ligne en haut, sinon votre premier enregistrement apparaîtra comme en-tête.

Si les lignes n'ont pas toutes le même nombre de colonnes, la plus large fait référence et les cellules manquantes restent vides ; le tableau ne casse pas. Une cellule vide ne pose aucun problème en Markdown.

Questions fréquentes

La première ligne doit-elle vraiment être un en-tête ?

Oui. Par définition, un tableau Markdown a une ligne d'en-tête et, dessous, une ligne d'alignement. Si vos données n'ont pas d'en-tête, ajoutez vous-même une ligne en haut.

Que se passe-t-il si une cellule contient une barre verticale ?

Elle est échappée par une barre oblique inverse et s'affiche comme un caractère normal dans le tableau. Sans cet échappement, elle couperait la colonne en deux et décalerait la ligne.

Les cellules multilignes sont-elles prises en charge ?

Le saut de ligne à l'intérieur des guillemets est remplacé par une balise <br>, car une cellule de tableau Markdown doit tenir sur une seule ligne. La plupart des moteurs de rendu affichent <br> comme un retour à la ligne.

Puis-je aligner chaque colonne différemment ?

L'outil applique un seul alignement. Pour varier, déplacez à la main les deux-points sur la deuxième ligne de la sortie ; le reste du tableau n'a pas besoin d'être touché.

Mes données sont-elles envoyées quelque part ?

Non. L'analyse et la construction du tableau se font dans votre navigateur ; ce que vous collez n'est envoyé à aucun serveur.