YAML to TOML Converter

No. Both formats support `#` line comments, but comments are trivia attached to the source text, not to the data model. The converter parses YAML into mappings, sequences, and scalars, then re-serializes that structure as TOML — any `#` comments in the original YAML are discarded in the process and won't appear in the TOML output.

YAML lets you write a mapping or sequence inline, like `{host: localhost, port: 5432}` or `[web, production]`, as an alternative to multi-line block style. TOML has a direct equivalent — inline tables (`{ host = "localhost", port = 5432 }`) and inline arrays (`["web", "production"]`). Since flow and block YAML parse to the identical data structure, the converter treats them the same way regardless of which style the source file used.

Yes. TOML's spec doesn't require any particular key order for two documents to be considered equivalent, but the converter still emits keys in the order they appeared in the YAML source, since standard parsers (PyYAML, js-yaml, ruamel.yaml) retain document order by default — this keeps diffs against the original file predictable.

TOML restricts unquoted ("bare") keys to ASCII letters, digits, underscores, and dashes. A YAML key like `first name` (a space) or `api.version` (a literal dot, which TOML would otherwise read as nested-table notation) doesn't fit that grammar, so the converter wraps it in quotes instead — producing `"first name" = "Jane"` — which TOML's spec defines as an equally valid alternative to a bare key.

Ja, aber verloren geht die Beziehung, nicht die Daten. YAML-Anker (`&name`) markieren einen Block zur Wiederverwendung, und Aliase (`*name`) kopieren diesen Inhalt an anderer Stelle im selben Dokument — häufig genutzt für gemeinsame Standardwerte, etwa einen `&defaults`-Anker, der über `<<: *defaults` in mehrere Umgebungskonfigurationen eingemischt wird. TOML kennt weder Anker noch Aliase noch Merge-Keys, weshalb der Konverter vor der Ausgabe jeden Alias zunächst zu seinem vollständig aufgelösten, wörtlichen Wert expandiert. Das Ergebnis ist datengleich — jedes Feld hat denselben Wert —, aber die 'einzige Quelle der Wahrheit' ist verschwunden: Änderte sich zuvor der Anker-Block, musste man ihn in YAML nur an einer Stelle anpassen, während man in TOML nun mehrere unabhängige Tables von Hand bearbeiten muss. Mehrdokument-YAML-Dateien (mehrere durch `---` getrennte Dokumente) stoßen aus einem anderen Grund an dieselbe Grenze: Eine TOML-Datei ist per Definition genau ein Dokument, sodass nur eines der YAML-Dokumente die Konvertierung übersteht.

Meist weil eine bestimmte Toolchain TOML verlangt und YAML nicht als Ersatz akzeptiert. Rusts Cargo liest `Cargo.toml`; Pythons Poetry, Hatch und PDM lesen `pyproject.toml`; Hugo akzeptiert TOML-Front-Matter in Content-Dateien; und jedes Tool, das auf Rusts `toml`-Crate oder Gos BurntSushi/toml-Bibliothek aufbaut, erwartet speziell TOML. Teams, die Infrastruktur- oder CI-Konfiguration bereits in YAML pflegen — Ansible-Playbooks, GitHub-Actions-Workflows, Kubernetes-Manifeste —, müssen mitunter bestimmte Werte (Servicenamen, Ports, Versionsangaben) aus diesen Dateien herauslösen und in ein TOML-basiertes Projekt- oder Paket-Manifest überführen, ohne jedes Feld von Hand neu abzutippen und Anführungszeichen sowie Typen erneut zu prüfen. Das Ausführen des YAML-Ausgangsfragments durch einen Konverter ist schneller und weniger fehleranfällig als das manuelle Übertragen verschachtelter Schlüssel in geklammerte TOML-Tables, besonders bei größeren Konfigurationsblöcken mit mehreren Verschachtelungsebenen.

YAML ist das deutlich ältere Format, um mehr als ein Jahrzehnt: Version 1.0 wurde 2004 von Clark Evans, Ingy döt Net und Oren Ben-Kiki veröffentlicht, und die aktuelle Revision, YAML 1.2.2, wurde 2021 finalisiert und definiert YAML als strikte Obermenge von JSON. TOML ist jünger und wurde 2013 von Tom Preston-Werner, einem Mitgründer von GitHub, geschaffen — mit dem Ziel, ein minimales, unzweideutiges Konfigurationsformat zu sein, eine Alternative sowohl zu YAMLs Komplexität als auch zu INIs fehlender Standardisierung. Cargo, Rusts Paketmanager, war ein früher und einflussreicher Anwender, was TOML als Standardwahl für Rust und später für Python-Paketmanifeste etablierte. TOML erreichte 2021 mit v1.0.0 seine erste stabile Version — demselben Jahr wie YAMLs letzte Revision —, sodass beide Spezifikationen, zwischen denen du heute konvertierst, jeweils in ihrer aktuellsten, stabilen Fassung vorliegen.

Nein — auch wenn beide stellenweise ähnlich aussehen, wurden sie unabhängig voneinander entwickelt, und TOMLs Syntax steht INI-Dateien (`[section]`-Überschriften, `key = value`-Zeilen) näher als YAMLs einrückungsgetriebenem Block-Stil. TOML kennt bewusst keinen Unterschied zwischen Flow- und Block-Stil, keine Anker oder Aliase, keine eigenen Typ-Tags und keine Mehrdokument-Dateien — es zielt darauf ab, für jede Struktur genau einen Weg der Schreibweise zu bieten, und genau das erlaubt es diesem Konverter, YAMLs verschachtelte Mappings deterministisch auf TOML-Tables abzubilden. Die Beziehung funktioniert nur in eine Richtung sauber: Jedes gültige TOML-Dokument lässt sich verlustfrei in YAML ausdrücken, umgekehrt gilt das nicht, da YAMLs Funktionsumfang eine strikte Obermenge dessen ist, was TOMLs Grammatik überhaupt ausdrücken kann.

Sauber, denn beide Formate behandeln sie als native Typen statt als Strings. YAMLs Core-Schema erkennt Zeitstempel-Skalare wie `2024-01-15` oder `2024-01-15T10:30:00Z` und markiert sie als Datumswerte statt als Text; TOML v1.0.0 definiert vier eigenständige Datums-/Zeittypen — Offset-Date-Time, Local-Date-Time, Local-Date und Local-Time — jeweils mit eigener Grammatik. Der Konverter bildet einen YAML-Zeitstempel auf denjenigen der vier TOML-Typen ab, der zu den tatsächlich vorhandenen Bestandteilen passt: Ein bloßes `2024-01-15` wird zu einem TOML-Local-Date, während ein Zeitstempel mit `Z`- oder `+00:00`-Offset zu einer Offset-Date-Time wird. Beide Formate folgen für diese Werte der RFC-3339-Formatierung, sodass keine Neuformatierung des Datumsstrings selbst nötig ist — nur die Typklassifizierung ändert sich auf der TOML-Seite.