Was ist das YAML-Dateiformat?
.yaml ist ein Textdateiformat zum Austausch von Daten zwischen verschiedenen Anwendungen. YAML - kurz für *YAML Ain't Markup Language* - ist ein Standard zur Organisation von Informationen in einem menschenlesbaren, plattformunabhängigen Format mit einrückungsbasierten key: value-Paaren in UTF-8-Kodierung. Das Parsen von .yaml-Dateien erfordert eine installierte YAML-Bibliothek; verbreitete Bibliotheken sind PyYAML (Python), js-yaml (JavaScript) und SnakeYAML (Java). .yaml-Dateien werden manchmal mit der Erweiterung .yml gespeichert, die funktional identisch ist. Neben dem Datenaustausch werden .yaml-Dateien typischerweise zur Datenserialisierung und für Konfigurationsdateien in Werkzeugen wie Docker Compose, Kubernetes und GitHub Actions verwendet.
Serialisierung
Serialisierung ist ein Begriff aus der Informatik. Er bezeichnet den Prozess der Umwandlung von Daten oder Objekten in ein Format, das gespeichert, übertragen und später rekonstruiert werden kann. Wenn zum Beispiel zwei Institutionen Daten in einem standardisierten Format über verschiedene Anwendungen austauschen, müssen sie diese Daten vor dem Versand serialisieren. Serialisierte Daten können auch in einer Datei gespeichert werden - .yaml, .xml, .json, .toml usw. - und dann an die Empfänger gesendet werden.
Ein .yaml-Dokument kann optional mit dem ----Dokumentstart-Marker beginnen und mit ... enden; dies ermöglicht auch mehrere Dokumente in einer einzigen Datei. Seit YAML 1.2 (2009, überarbeitet 2021) ist jede gültige JSON-Datei auch gültiges YAML.
Sicherheit
RISIKO: MEDIUMEine YAML-Datei ist reiner Text und wird nicht von selbst ausgeführt, daher ist das Lesen sicher. Zwei reale Risiken: (1) Konfigurations-YAML (CI-Pipelines, Compose, K8s, Ansible) enthält häufig Geheimnisse - Tokens, Passwörter, Schlüssel - also fügen Sie es nicht in nicht vertrauenswürdige Online-Validatoren ein oder committen Sie es öffentlich. (2) Programmatische Gefahr: Das Laden von nicht vertrauenswürdigem YAML mit einem unsicheren Parser (z. B. PyYAMLs yaml.load statt yaml.safe_load) kann beliebige Objekte/Code ausführen - verwenden Sie immer den sicheren Loader für nicht vertrauenswürdige Dateien. Bearbeitungsrisiko: Ein Tabulator oder ein falsch ausgerichtetes Leerzeichen ändert stillschweigend die Bedeutung, also nach dem Bearbeiten validieren.
Formatdetails
kurz gefasstVOLLSTÄNDIGER NAMEYAML Ain't Markup Language file
ENTWICKLERClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)seit 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
KATEGORIEDeveloperdateien
MIME TYPEapplication/yaml
TYPMenschenlesbarer Datenserialisierungstext (einrückungsbasiert, UTF-8)
STANDARDOffen · lizenzfrei
Programme zum Öffnen von YAML-Dateien
Windows4 apps
Sublime Text
Freemium Die .yaml-Datei für schnelles Bearbeiten mit YAML-Hervorhebung öffnen; 'Tabulatoren in Leerzeichen übersetzen' konfigurieren, damit die Einrückung gültig bleibt. 
Windows Notepad
Integriert Öffnet YAML als Text zur schnellen Ansicht - zeigt aber keine Leerzeichen/Tabulatoren an, was das Bearbeiten von einrückungsempfindlichem YAML riskant macht. 
Notepad
Open Source Mit YAML-Syntaxhervorhebung öffnen; Ansicht > Symbol anzeigen > Leerzeichen anzeigen aktivieren, um die Einrückung korrekt zu halten. 
Visual Studio Code
Kostenlos Datei öffnen; die integrierte/Red Hat YAML-Erweiterung bietet Hervorhebung, Einrückungshilfen, Schema-Validierung und Fehlermarkierungen. Beste Wahl für YAML. 
macOS3 apps
TextEdit
Integriert Zuerst Format > Als normalen Text umwandeln und typografische Anführungszeichen deaktivieren - zeigt aber keine Leerzeichen an, daher für die Bearbeitung einen Code-Editor bevorzugen.
Visual Studio Code
Kostenlos Datei öffnen; die integrierte/Red Hat YAML-Erweiterung bietet Hervorhebung, Einrückungshilfen, Schema-Validierung und Fehlermarkierungen. Beste Wahl für YAML. 
Sublime Text / BBEdit
Freemium Die .yaml-Datei in einem Code-Editor mit YAML-Hervorhebung und leerzeichen-basierter Einrückung öffnen. 
Linux3 apps
Visual Studio Code
Kostenlos Datei öffnen; die integrierte/Red Hat YAML-Erweiterung bietet Hervorhebung, Einrückungshilfen, Schema-Validierung und Fehlermarkierungen. Beste Wahl für YAML.
GNOME Text Editor / gedit
Open Source Mit YAML-Hervorhebung öffnen; vor dem Bearbeiten auf Leerzeichen (keine Tabulatoren) einstellen.
vim / nano
Open Source Im Terminal bearbeiten; in Vim ':set expandtab' verwenden, damit die Einrückung Leerzeichen verwendet. Standard für Server-Konfigurationsdateien.
Web1 app
YAML Lint / online YAML validators
Kostenlos Datei zur Syntax-Validierung und zum Formatieren im Browser einfügen. Keine Geheimnisse einfügen - Konfigurations-YAML enthält häufig Zugangsdaten. Technische Details
technische Spezifikation| Dateiendung | .yaml (auch .yml) |
| MIME-Typ | application/yaml |
| Kodierung | UTF-8-Klartext; kein binärer Header oder Magic Bytes |
| Struktur | Einrückungsbasierte Schlüssel: Wert-Paare; Einrückung verwendet nur Leerzeichen - Tabulatoren sind gemäß der Spezifikation verboten |
| Dokument-Marker | --- markiert den Dokumentstart, ... markiert das Dokumentende; mehrere Dokumente können in einer Datei koexistieren |
| Native Datentypen | Zeichenketten, Ganzzahlen, Gleitkommazahlen, Boolesche Werte, Null, Sequenzen (Listen), Mappings (Wörterbücher), Zeitstempel |
| Spezifikationsversion | YAML 1.2 (2009, überarbeitet 2021); ersetzt YAML 1.1 (2005) und YAML 1.0 (2001) |
| JSON-Kompatibilität | Seit YAML 1.2 ist jedes gültige JSON-Dokument auch gültiges YAML - JSON ist eine strikte Teilmenge |
| Kommentare | Einzeilige Kommentare, eingeleitet durch # ; können in einer eigenen Zeile oder inline nach einem Wert stehen |
| Mehrzeilige Zeichenketten | Literaler Block-Skalar (|) erhält Zeilenumbrüche; gefalteter Skalar (>) wandelt Zeilenumbrüche in Leerzeichen um |
| Anker und Aliasse | & definiert einen benannten Anker und * verweist (als Alias) darauf, was die Wiederverwendung von Werten ohne Duplizierung ermöglicht |
| Entwickler | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Häufige Anwendungsfälle | Konfigurationsdateien (Kubernetes, Docker Compose, GitHub Actions, Ansible), Datenserialisierung, OpenAPI-Definitionen |
| Anführungszeichen | Unzitiert, einfach zitiert ('...') und doppelt zitiert ("...") werden alle unterstützt; doppelt zitiert erlaubt Escape-Sequenzen |
| Veröffentlicht | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Offener Standard | Ja · lizenzgebührenfrei |
| Spezifikation | yaml.org |
YAML-Konvertierungen
Möglich
.YAML .JSONANLEITUNG
Ja - YAML und JSON teilen dasselbe Datenmodell, daher ist die Konvertierung verlustfrei; lediglich…
So konvertieren Sie
.YAML .XMLANLEITUNG
Ja - YAML und XML beschreiben beide hierarchische Daten, daher ist die Konvertierung unkompliziert, obwohl…
So konvertieren Sie
.YAML .TOMLANLEITUNG
Ja, YAML kann in TOML konvertiert werden -- die schnellste Methode ist ein yq-Befehl: yq -o=toml file.yaml >…
So konvertieren Sie
.YAML .CSVANLEITUNG
Ja - aber nur, wenn die .yaml-Datei eine flache, einheitliche Liste von Datensätzen ist; verschachtelte…
So konvertieren Sie
.YAML .YMLANLEITUNG
Ja - .yaml und .yml sind das gleiche Format; das Umbenennen der Datei ist alles, was Sie tun müssen.
So konvertieren Sie
Nicht möglich
Community Q&A
von Nutzern gefragt
I
Häufig gestellte Fragen
Was ist der Unterschied zwischen .yaml und .yml?
Keiner - es ist dasselbe YAML-Format mit zwei Erweiterungen. .yml ist die ältere 3-Buchstaben-Form. Verwenden Sie, was das Werkzeug erwartet; Sie können die Datei einfach umbenennen.
Wie öffne ich eine .yaml-Datei?
Mit einem beliebigen Code-/Texteditor. VS Code (mit der YAML-Erweiterung) ist die beste Wahl, da er die Struktur hervorhebt und Einrückungsfehler anzeigt; Notepad++ und Sublime Text funktionieren ebenfalls. Es ist reiner Text, also öffnet Notepad die Datei - zeigt aber keine Leerzeichen an, auf die YAML angewiesen ist.
Warum gibt mein YAML einen Einrückungs-/Parse-Fehler aus?
YAML verwendet Leerzeichen für die Struktur und verbietet Tabulatoren, sodass ein verirrter Tabulator oder eine falsch ausgerichtete Zeile die Datei beschädigt. Öffnen Sie es in einem YAML-fähigen Editor (Leerzeichen anzeigen, Tabulatoren in Leerzeichen umwandeln) oder fügen Sie es in einen Online-YAML-Validator ein, um die genaue Zeile zu finden.
Wie konvertiere ich YAML in JSON?
Verwenden Sie 'yq -o=json file.yaml', einen VS Code-Befehl oder einen Online-Konverter. Es ist im Wesentlichen verlustfrei, da JSON eine Teilmenge von YAML ist - nur Kommentare gehen verloren.
Kann ich Tabulatoren in YAML verwenden?
Nein. YAML erlaubt nur Leerzeichen zur Einrückung; Tabulatoren verursachen einen Parse-Fehler. Stellen Sie Ihren Editor so ein, dass Leerzeichen eingefügt werden (z. B. ':set expandtab' in Vim oder 'Tabulatoren in Leerzeichen umwandeln' in Sublime Text).
Ist YAML nur für Python?
Nein - das ist ein weit verbreitetes Missverständnis. YAML ist sprachunabhängig und wird überall verwendet: Docker Compose, Kubernetes, GitHub Actions, Ansible, Go/Java/JS-Apps und mehr. Python hat nur zufällig eine beliebte YAML-Bibliothek (PyYAML).
Quellen
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
