Zum Hauptinhalt springen
ToolsByUs

YAML zu CSV

Dieser Konverter wandelt eine YAML-Folge von Zuordnungen in RFC-4180-CSV in Ihrem Browser um. Verschachtelte Werte werden zu Spaltenpfaden abgeflacht, Felder werden nur bei Bedarf in Anführungszeichen gesetzt, und Zeilen enden mit CRLF – genau die Datei, die eine Tabellenkalkulation erwartet. Nichts wird hochgeladen.

Nur lokal

YAML zu CSV erklärt

YAML liebt Verschachtelungen; Tabellenkalkulationen lieben flache Zeilen. Zwischen beiden liegt eine mechanische Frage: Wie werden die Schlüssel einer verschachtelten Zuordnung zu den Überschriften einer Tabelle? Dieser Konverter beantwortet sie auf die Weise, wie es der Rest des Ökosystems tut – mit Spaltenpfaden. Ein Datensatz, dessen address-Objekt ein city-Feld enthält, erzeugt eine address.city-Spalte, sodass keine Informationen verloren gehen und keine Schlüssel kollidieren.

Die CSV-Seite ist strikt RFC 4180: Komma als Trennzeichen, doppelte Anführungszeichen zur Escapierung, wenn ein Feld ein Komma, ein Anführungszeichen oder einen Zeilenumbruch enthält, und CRLF als Zeilenende. Felder werden nur dann in Anführungszeichen gesetzt, wenn sie es müssen, weil jedes überflüssige Anführungszeichen eine weitere Sache ist, mit der ein nachgelagerter Skript robust umgehen muss. Das Ergebnis öffnet sich direkt in Excel, Numbers, LibreOffice und Google Sheets.

Alles läuft in diesem Browser-Tab. Der YAML-Text, den Sie einfügen, wird von einer im Seiten-Code enthaltenen Engine verarbeitet, die CSV wird aus den verarbeiteten Datensätzen aufgebaut, und beide berühren niemals ein Netzwerk – öffnen Sie DevTools, beobachten Sie, wie das Netzwerk-Panel stumm bleibt, und die Behauptung bestätigt sich selbst.

Die andere Richtung – eine Tabellenkalkulationsexport zurück in eine Konfiguration zu wandeln – ist derselben Engine umgekehrt, und die CSV zurück zu YAML konvertieren Seite liest die Spaltenpfade-Konvention rückwärts.

Wenn Ihre Quelldaten JSON statt YAML sind, die dedizierte JSON zu CSV Konverter Seite deckt es mit den gleichen Abflachungsregeln ab.

Wie die Konvertierung tatsächlich funktioniert

Die Engine verarbeitet Ihr YAML zunächst in Datensätze, da YAML-Dateien, die sich gut tabellarisch darstellen lassen, Folgen von Zuordnungen sind – eine Liste auf oberster Ebene, deren jedes Element Schlüssel hat. Die verschachtelten Werte jedes Datensatzes werden zu durch Punkte getrennten Spaltenpfaden abgeflacht, die Vereinigung dieser Pfade über alle Datensätze wird zur Kopfzeile, und jeder Datensatz füllt die Spalten, die er hat, und lässt leere Zellen, wo er welche nicht hat.

  • Verarbeitung: Der YAML-Text wird als Folge von Zuordnungen gelesen. Eine Datei, deren oberste Ebene eine einzelne Zuordnung ist, erhält eine klare Fehlermeldung, die eine Liste verlangt.
  • Abflachen: Verschachtelte Zuordnungen und Arrays werden zu Spaltenpfaden – address.city, tags.0, tags.1.
  • Vereinigung: Die Kopfzeile ist die geordnete Vereinigung aller Spaltenpfade der Datensätze, zuerst gesehen zuerst, sodass die Spalten in einer stabilen, vorhersagbaren Reihenfolge gelesen werden.
  • Ausgabe: Jeder Datensatz wird als eine mit CRLF beendete Zeile geschrieben, Felder gemäß RFC 4180 nur dann in Anführungszeichen gesetzt, wenn der Inhalt es erfordert.

Wie das Ergebnis aussieht

Das untenstehende Arbeitsbeispiel ist genau das Paar, das der Konverter mit der Schaltfläche Beispieldaten laden erzeugt: zwei Personendatensätze, einer mit einer verschachtelten Adresse und einem Array von Tags. Beobachten Sie, was mit jeder Form geschieht – das address-Objekt erzeugt zwei Spalten, das tags-Array wird mit Index nummeriert, und das Komma in einem note-Feld löst genau in diesem Feld die Anführungszeichen aus.

Randfälle, dieser Konverter verweigert sie statt sie zu verzerren

Ein ehrlicher Konverter hat Ränder, und das Schlimmste, was er tun kann, ist vorzutäuschen, er hätte keine. Drei Eingaben werden mit einer spezifischen Nachricht abgelehnt, anstatt still umgeformt zu werden, weil jede bedeutet, dass das Ergebnis Sie täuschen würde:

  • Eine Zuordnung auf oberster Ebene statt einer Folge – ein einzelnes Konfigurationsobjekt ist keine Tabelle, und das Erfinden einer einzeiligen Tabelle würde den Fehler verbergen.
  • Folgenelemente, die Skalare oder Arrays sind – eine Liste von Zeichenfolgen kann nicht in benannte Spalten tabellarisch dargestellt werden.
  • Homogene Schlüssel, die sich stark zwischen Datensätzen unterscheiden – die Vereinigung wird trotzdem konvertiert, aber die Vorschau zeigt Ihnen das unregelmäßige Ergebnis, damit Sie vor dem Speichern entscheiden können.

Häufig gestellte Fragen

Lädt die Konvertierung von YAML zu CSV meine Datei irgendwo hoch?

Nein. Die Verarbeitung und CSV-Erstellung laufen beide in diesem Browser-Tab mit JavaScript, das beim Öffnen der Seite einmal geladen wurde. Die Seite hat keine API-Route, an die Daten gesendet werden könnten, und die Content-Security-Policy verbietet der Seite, sich irgendwo sonst zu verbinden. Sie können beide Behauptungen in DevTools überprüfen: das Netzwerk-Panel zeigt beim Konvertieren keine Anfrage.

Wie werden verschachtelte YAML-Werte in der CSV-Ausgabe behandelt?

Verschachtelte Zuordnungen werden zu durch Punkte getrennten Spaltenpfaden abgeflacht – ein address-Objekt mit einem city-Feld wird zu einer address.city-Spalte. Arrays werden zu indizierten Pfaden wie tags.0 und tags.1 abgeflacht. Keine Daten werden verworfen: jeder Blattwert im YAML landet in genau einer Zelle.

Welche YAML-Syntax akzeptiert der Parser?

Der alltägliche Kern: Folgen und Zuordnungen, einfache und in Anführungszeichen gesetzte Skalare, Kommentare, Boolesche Werte, Ganzzahlen, Fließkommazahlen, null und Blockskalare. Direktiven, Anker und Aliase sowie Merge-Keys liegen außerhalb des unterstützten Satzes des Konverters und werden mit einem benannten Fehler abgelehnt, anstatt geraten zu werden – die Seite dokumentiert genau diese Teilmenge, sodass ein Misserfolg niemals eine Überraschung ist.

Warum enden meine Zeilen mit CRLF, und kann ich das ändern?

RFC 4180 spezifiziert CRLF (\r\n) als Zeilenabschluss, und das ist, was der Konverter standardmäßig ausgibt, weil es das ist, was die maximale kompatible Tabellenkalkulationssoftware erwartet. Werkzeuge, die LF bevorzugen, akzeptieren CRLF in der Regel trotzdem; wenn Ihre Pipeline diesbezüglich streng ist, konvertieren Sie zuerst und führen Sie die Ausgabe anschließend durch eine Zeilen-normalisierende Schritt.

Gibt es eine Dateigrößen- oder Zeilenbegrenzung?

Die Grenze ist der Speicher des Browser-Tabs, keine Upload-Grenze. Die Engine verarbeitet auf dem Hauptthread und lehnt Dokumente über 8 MB mit einer klaren Nachricht ab, anstatt die Seite einfrieren zu lassen – dieselbe dokumentierte Grenze, die jedes andere Hauptthread-Tool auf dieser Seite anwendet. Für typische Konfigurationsexporte sind das Tausende von Zeilen.

Wie öffne ich die CSV in Excel mit der richtigen Kodierung?

Der Download ist UTF-8 ohne Byte Order Mark. Modernes Excel handelt das korrekt über Daten → Aus Text/CSV; ältere Versionen gehen manchmal von einer veralteten Codepage aus und verzerren nicht-ASCII-Zeichen. Wenn Sie Mojibake sehen, verwenden Sie den Importdialog von Excel, wählen Sie UTF-8 als Quelle, und die Daten landen korrekt.

ToolsByUs-Team · Wie wir unsere Tools prüfen