CSV to YAML

Was ist CSV-zu-YAML-Konvertierung?

Die CSV-zu-YAML-Konvertierung wandelt tabellarische, kommagetrennte Daten in das YAML-Format (YAML Ain't Markup Language) um. Jede Zeile der CSV-Datei wird zu einem Eintrag in einer YAML-Sequenz, und jeder Spaltenkopf wird zum Schlüssel in einem YAML-Mapping. Das Ergebnis ist ein menschenlesbares, einrückungsbasiertes Dokument, das Konfigurationswerkzeuge und Datenpipelines direkt parsen können — ohne zusätzliche Schema-Dateien.

YAML wurde erstmals 2001 vorgeschlagen und erreichte seine aktuelle Spezifikation (YAML 1.2) im Jahr 2009. Es ist das Standard-Konfigurationsformat für Kubernetes-Manifeste, Docker-Compose-Dateien, Ansible-Playbooks, GitHub-Actions-Workflows und viele CI/CD-Systeme. Wenn die Quelldaten in einer Tabellenkalkulation oder einem Datenbankexport vorliegen, ist die CSV-zu-YAML-Konvertierung der schnellste Weg, um Konfigurationseinträge, Seed-Data-Fixtures oder Testeingaben für diese Systeme zu erzeugen.

Ein korrekter CSV-zu-YAML-Konverter muss die RFC-4180-Parsing-Regeln beachten: Felder in Anführungszeichen mit Kommas oder Zeilenumbrüchen, maskierte doppelte Anführungszeichen und unterschiedliche Trennzeichen. Auf der YAML-Seite müssen Zeichenketten, die wie Booleans (yes, no, true, false), Zahlen oder null aussehen, in Anführungszeichen gesetzt werden, damit YAML-Parser sie nicht in unbeabsichtigte Typen umwandeln. Der Konverter sollte außerdem Unicode-Inhalte verarbeiten und gültige UTF-8-Ausgaben erzeugen, da YAML 1.2 UTF-8 als Standard-Kodierung vorschreibt.

Warum einen CSV-zu-YAML-Konverter verwenden?

YAML aus Tabellendaten manuell zu schreiben ist mühsam und fehleranfällig. Eine falsch gesetzte Einrückung oder ein nicht in Anführungszeichen gesetztes Sonderzeichen erzeugt ungültiges YAML, das Konfigurations-Deployments oder Datenimporte abbricht. Dieser Konverter parst CSV-Felder, ordnet Spaltenköpfe als Schlüssel zu und erzeugt korrekt eingerücktes, sauber gequotetes YAML.

Anwendungsfälle für CSV zu YAML

CSV-zu-YAML-Zuordnungsreferenz

Jedes strukturelle Element einer CSV-Datei hat ein direktes Gegenstück in YAML.

CSV vs. YAML

CSV ist ein flaches, trennzeichenbasiertes Format ohne Typinformationen oder Hierarchie. YAML ist eine Obermenge von JSON, die Einrückungen für Verschachtelungen nutzt, mehrere Datentypen unterstützt und Kommentare erlaubt. Die Wahl hängt davon ab, was das nachgelagerte Tool erwartet.

Code-Beispiele

Funktionierende Beispiele in Node.js, Python, Go und CLI-Tools. Jedes liest die CSV-Kopfzeile als YAML-Schlüssel, ordnet jede Datenzeile einem Sequenzeintrag zu und setzt typambivalente Werte in Anführungszeichen.

import { parse } from 'csv-parse/sync'
import { stringify } from 'yaml'

const csv = `name,age,city
Alice,30,Berlin
Bob,25,"New York"`

const records = parse(csv, { columns: true, skip_empty_lines: true })
console.log(stringify(records))
// → - name: Alice
// →   age: "30"
// →   city: Berlin
// → - name: Bob
// →   age: "25"
// →   city: New York

// Vanilla JS (no dependencies)
function csvToYaml(csv) {
  const [headerLine, ...dataLines] = csv.trim().split('\n')
  const headers = headerLine.split(',')
  return dataLines.map(line => {
    const values = line.split(',')
    return headers.map((h, i) => `  ${h}: ${values[i] || ''}`).join('\n')
  }).map(block => `- ${block.trimStart()}`).join('\n')
}

import csv, io, yaml

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

reader = csv.DictReader(io.StringIO(csv_string))
data = list(reader)

# default_flow_style=False produces block-style YAML
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
# → - age: '30'
# →   city: Berlin
# →   name: Alice
# → - age: '25'
# →   city: New York
# →   name: Bob

# Preserve insertion order with sort_keys=False (Python 3.7+)
# To type-cast numbers: data = [{k: int(v) if v.isdigit() else v ...}]

package main

import (
	"encoding/csv"
	"fmt"
	"gopkg.in/yaml.v3"
	"strings"
)

func main() {
	input := "name,age,city
Alice,30,Berlin
Bob,25,New York"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()
	headers := records[0]

	var data []map[string]string
	for _, row := range records[1:] {
		entry := make(map[string]string)
		for i, h := range headers {
			entry[h] = row[i]
		}
		data = append(data, entry)
	}

	out, _ := yaml.Marshal(data)
	fmt.Println(string(out))
	// → - age: "30"
	// →   city: Berlin
	// →   name: Alice
	// → - age: "25"
	// →   city: New York
	// →   name: Bob
}

# Using yq (https://github.com/mikefarah/yq)
# yq reads CSV with --input-format=csv
yq --input-format=csv --output-format=yaml '.' data.csv

# Using Miller (mlr) — converts between CSV, JSON, YAML, and more
mlr --icsv --oyaml cat data.csv

# Python one-liner for quick conversion
python3 -c "
import csv, sys, yaml
data = list(csv.DictReader(sys.stdin))
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
" < data.csv

Häufig gestellte Fragen