CSV to Markdown

Was ist CSV-zu-Markdown-Konvertierung?

CSV in eine Markdown-Tabelle zu konvertieren ist eine gängige Entwickleraufgabe. CSV (Comma-Separated Values) speichert tabellarische Daten als Klartext, wobei jede Zeile eine eigene Zeile belegt und Felder durch ein Trennzeichen wie ein Komma oder Tab getrennt sind. Es ist das Standard-Exportformat für Tabellenkalkulationen, SQL-Clients und Analyse-Tools. CSV-Dateien sind kompakt und einfach zu erzeugen, bieten jedoch keine eingebaute Möglichkeit, die Darstellung der Daten zu steuern. Eine in einem Texteditor geöffnete CSV-Datei ist eine Wand aus kommagetrennte Zeichenketten — maschinenlesbar, aber für Menschen schwer zu erfassen.

Markdown-Tabellen lösen dieses Lesarkeitsproblem. Sie sind im GitHub Flavored Markdown (GFM)-Standard definiert und werden von GitHub, GitLab, Bitbucket, Notion, Obsidian und statischen Site-Generatoren wie Hugo und Jekyll unterstützt — überall, wo Markdown verarbeitet wird, werden sie als saubere HTML-Tabellen gerendert. Die Syntax verwendet Pipe-Zeichen zur Spaltentrennung und eine obligatorische Trennzeile aus Bindestrichen zwischen der Kopfzeile und den Datensätzen.

CSV in eine Markdown-Tabelle zu konvertieren bedeutet, jede Zeile in eine pipe-getrennte Syntax einzubetten und die Trennzeile nach der Kopfzeile einzufügen. Die erste Zeile der CSV wird zur Tabellenüberschrift, jede weitere Zeile wird zu einem Datensatz. Dies ist immer dann nötig, wenn strukturierte Daten in eine README, eine Pull-Request-Beschreibung, eine Wiki-Seite oder ein Markdown-Dokumentationssystem eingefügt werden sollen.

Warum dieses Tool verwenden?

Dieser Konverter verarbeitet dein CSV direkt im Browser, erstellt die Markdown-Tabellenausgabe sofort und überträgt deine Daten nie an einen Server.

CSV-zu-Markdown-Anwendungsfälle

Markdown-Tabellensyntax-Referenz

Markdown-Tabellen folgen der GitHub Flavored Markdown (GFM)-Spezifikation. Jede Tabelle erfordert eine Kopfzeile, eine Trennzeile und eine oder mehrere Datensätze. Die Trennzeile steuert die Spaltenausrichtung.

CSV vs. Markdown-Tabelle

Beide Formate stellen tabellarische Daten als Klartext dar. CSV ist für Maschinen und Datenpipelines gedacht; Markdown-Tabellen sind für Menschen, die Dokumentation lesen.

Code-Beispiele

Die folgenden Beispiele zeigen, wie CSV programmgesteuert in eine Markdown-Tabelle in verschiedenen Sprachen konvertiert wird. Jedes erzeugt eine gültige GFM-Tabelle.

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

Häufig gestellte Fragen