CSV to Markdown

Wat is CSV naar Markdown-conversie?

CSV naar een Markdown-tabel converteren is een veelvoorkomende taak voor ontwikkelaars. CSV (Comma-Separated Values) slaat tabellarische data op als platte tekst, waarbij elke rij op een eigen regel staat en velden worden gescheiden door een scheidingsteken zoals een komma of tab. Het is het standaard exportformaat voor spreadsheets, SQL-clients en analysetools. CSV-bestanden zijn compact en eenvoudig te genereren, maar ze bieden geen ingebouwde manier om te bepalen hoe de data eruitziet wanneer deze wordt weergegeven. Een CSV-bestand geopend in een teksteditor is een muur van komma-gescheiden waarden: leesbaar voor machines, maar moeilijk voor mensen om snel te doorzoeken.

Markdown-tabellen lossen dit leesbaarheids­probleem op. Ze zijn gedefinieerd in de GitHub Flavored Markdown (GFM)-specificatie en worden ondersteund door GitHub, GitLab, Bitbucket, Notion, Obsidian en statische sitegeneratoren zoals Hugo en Jekyll — overal waar Markdown wordt verwerkt, worden ze weergegeven als nette HTML-tabellen. De syntaxis gebruikt pipe-tekens om kolommen te scheiden en een verplichte scheidingsrij van streepjes tussen de koptekst- en tekstrijen.

CSV naar een Markdown-tabel converteren betekent elke rij omhullen in pipe-gescheiden syntaxis en de scheidingsrij invoegen na de koptekst. De eerste rij van de CSV wordt de tabelkoptekst, en elke volgende rij wordt een tekstrij. Je hebt dit nodig wanneer je gestructureerde data plakt in een README, een pull request-beschrijving, een wikipagina of een ander Markdown-documentatiesysteem.

Waarom dit hulpmiddel gebruiken?

Deze converter verwerkt je CSV in de browser, genereert de Markdown-tabeluitvoer direct en stuurt je data nooit naar een server.

Toepassingen van CSV naar Markdown

Referentie voor Markdown-tabelsyntaxis

Markdown-tabellen volgen de GitHub Flavored Markdown (GFM)-specificatie. Elke tabel vereist een koptekstrij, een scheidingsrij en een of meer tekstrijen. De scheidingsrij bepaalt de kolomuitlijning.

CSV vs Markdown-tabel

Beide formaten stellen tabellarische data voor als platte tekst. CSV is bedoeld voor machines en datapipelines; Markdown-tabellen zijn bedoeld voor mensen die documentatie lezen.

Codevoorbeelden

De volgende voorbeelden laten zien hoe je CSV programmatisch naar een Markdown-tabel converteert in verschillende talen. Elk voorbeeld produceert een geldige GFM-tabel.

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

Veelgestelde vragen