CSV vers Markdown

Qu'est-ce que la conversion CSV vers Markdown ?

Convertir du CSV en tableau Markdown est une tâche courante pour les développeurs. CSV (Comma-Separated Values) stocke des données tabulaires en texte brut, chaque ligne correspondant à un enregistrement et les champs étant séparés par un délimiteur tel qu'une virgule ou une tabulation. C'est le format d'export par défaut des tableurs, des clients SQL et des outils d'analyse. Les fichiers CSV sont compacts et faciles à générer, mais ils n'offrent aucun moyen natif de contrôler l'apparence des données à l'affichage. Un fichier CSV ouvert dans un éditeur de texte est un mur de chaînes délimitées, lisible par des machines mais difficile à parcourir pour un humain.

Les tableaux Markdown résolvent ce problème de lisibilité. Ils sont définis par la spécification GitHub Flavored Markdown (GFM) et pris en charge par GitHub, GitLab, Bitbucket, Notion, Obsidian, ainsi que par les générateurs de sites statiques comme Hugo et Jekyll — partout où Markdown est interprété, ils s'affichent sous forme de tableaux HTML propres. La syntaxe utilise des caractères pipe pour séparer les colonnes et une ligne de séparation obligatoire de tirets entre la ligne d'en-tête et les lignes de contenu.

Convertir du CSV en tableau Markdown consiste à envelopper chaque ligne dans une syntaxe délimitée par des pipes et à insérer la ligne de séparation après l'en-tête. La première ligne du CSV devient l'en-tête du tableau, et chaque ligne suivante devient une ligne de contenu. Cette conversion est nécessaire dès que vous collez des données structurées dans un README, une description de pull request, une page wiki ou tout système de documentation Markdown.

Pourquoi utiliser cet outil ?

Ce convertisseur analyse votre CSV dans le navigateur, génère le tableau Markdown instantanément et ne transmet jamais vos données vers un serveur.

Cas d'utilisation CSV vers Markdown

Référence de la syntaxe des tableaux Markdown

Les tableaux Markdown suivent la spécification GitHub Flavored Markdown (GFM). Chaque tableau requiert une ligne d'en-tête, une ligne de séparation et une ou plusieurs lignes de contenu. La ligne de séparation contrôle l'alignement des colonnes.

CSV vs tableau Markdown

Les deux formats représentent des données tabulaires en texte brut. CSV est destiné aux machines et aux pipelines de données ; les tableaux Markdown sont destinés aux humains qui lisent de la documentation.

Exemples de code

Les exemples suivants montrent comment convertir du CSV en tableau Markdown par programmation dans différents langages. Chacun produit un tableau GFM valide.

const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')

const separator = '| ' + headers.map(() => '---').join(' | ') + ' |'
const headerRow = '| ' + headers.join(' | ') + ' |'
const bodyRows = rows.map(row =>
  '| ' + row.split(',').join(' | ') + ' |'
)

const markdown = [headerRow, separator, ...bodyRows].join('\n')
// → | name | age | city |
// → | --- | --- | --- |
// → | Alice | 30 | Berlin |
// → | Bob | 25 | Tokyo |

import csv
import io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.reader(io.StringIO(csv_string))
rows = list(reader)
headers = rows[0]

lines = []
lines.append('| ' + ' | '.join(headers) + ' |')
lines.append('| ' + ' | '.join('---' for _ in headers) + ' |')
for row in rows[1:]:
    lines.append('| ' + ' | '.join(row) + ' |')

print('\n'.join(lines))
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |
# → | Bob | 25 | Tokyo |

# With pandas (one-liner)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_markdown(index=False))

package main

import (
	"encoding/csv"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var lines []string

	lines = append(lines, "| "+strings.Join(headers, " | ")+" |")
	sep := make([]string, len(headers))
	for i := range sep {
		sep[i] = "---"
	}
	lines = append(lines, "| "+strings.Join(sep, " | ")+" |")

	for _, row := range records[1:] {
		lines = append(lines, "| "+strings.Join(row, " | ")+" |")
	}

	fmt.Println(strings.Join(lines, "\n"))
	// → | name | age | city |
	// → | --- | --- | --- |
	// → | Alice | 30 | Berlin |
	// → | Bob | 25 | Tokyo |
}

# Using Miller (mlr) — convert CSV to Markdown table
mlr --icsv --omarkdown cat data.csv
# → | name | age | city |
# → | --- | --- | --- |
# → | Alice | 30 | Berlin |

# Using csvtomd (pip install csvtomd)
csvtomd data.csv

# Using pandas in a one-liner
python3 -c "
import pandas as pd, sys
print(pd.read_csv(sys.argv[1]).to_markdown(index=False))
" data.csv

Questions fréquentes