Wie Werte umgewandelt werden
YAML-Mappings werden zu JSON-Objekten, Sequenzen zu Arrays. Zahlen, true, false und null ohne Anführungszeichen werden zu JSON-Zahlen, Booleans und null; alles in Anführungszeichen bleibt Text, DEBUG: "false" ergibt also den String "false". Datumswerte wie 2026-11-10 werden zu ISO-Strings, weil JSON keinen Datumstyp hat.
Mehrere Dokumente in einer Datei
Eine YAML-Datei kann mehrere Dokumente enthalten, getrennt durch eine Zeile mit drei Bindestrichen (---), wie viele Kubernetes-Dateien. Bei mehr als einem Dokument ist das Ergebnis ein JSON-Array mit einem Element pro Dokument, in der ursprünglichen Reihenfolge.
Was verloren geht
JSON kennt keine Kommentare, YAML-Kommentare entfallen daher. Anker und Aliase (&name und *name) werden zu vollständigen Kopien aufgelöst. Eigene Tags wie !Ref aus CloudFormation werden nicht akzeptiert: Es wird nur Standard-YAML gelesen, was das Parsen auch sicher macht.
Beispiel
Eine kleine Docker-artige Konfiguration. "false" in Anführungszeichen bleibt ein String, Zahlen ohne Anführungszeichen bleiben Zahlen.
Eingabe
name: web image: nginx:1.27 ports: - 80 - 443 env: DEBUG: "false" MODE: prod
Ergebnis
{
"name": "web",
"image": "nginx:1.27",
"ports": [
80,
443
],
"env": {
"DEBUG": "false",
"MODE": "prod"
}
}