TOML

Was ist eine TOML-Datei?

Ein Konfigurationsformat, das lesbar bleibt, ohne YAMLs Einrückungsfallen mitzubringen.

Was TOML ist

TOML ist ein reines Textformat, das sich in jedem Editor öffnen lässt. Eingesetzt wird es für die Bearbeitung.

Die Endung lautet .toml, der volle Name Tom's Obvious Minimal Language. Beides sagt weniger aus als das, was die Datei halten kann — und davon handelt der Rest dieser Seite.

Woher TOML kommt

Es geht auf 2013 zurück. Die Spezifikation ist TOML 1.0.

Das Alter ist aus einem praktischen Grund interessant: je älter ein Format, desto mehr Programme hatten Zeit, es zu lernen.

Die Spezifikation ist öffentlich

Jeder darf sie umsetzen, ohne zu fragen und ohne zu zahlen. Deshalb taucht das Format in so vielen Programmen auf, und deshalb gehen Dateien von vor zwanzig Jahren heute noch auf.

Es wird nichts weggeworfen

TOML speichert seinen Inhalt exakt. Erneutes Speichern ändert nichts, es lässt sich also beliebig oft öffnen, bearbeiten und wieder ablegen, ohne dass sich Schaden ansammelt — genau das macht es zu einem Arbeitsformat und nicht zu einem Ausgabeformat.

Man kann Notizen hineinschreiben

TOML hat eine Kommentarsyntax — das ist der Unterschied zwischen einer Datei, die ein Mensch pflegt, und einer, die ein Programm schreibt. Beim Umwandeln in ein Format ohne Kommentare sind sie das Erste, was verschwindet, und gewarnt wird nicht.

Was TOML öffnet

Visual Studio Code liest es, und die meisten Programme derselben Art ebenfalls.

Wenn eine Datei nicht aufgeht, liegt es selten am Format — häufiger daran, dass das Programm älter ist als das Format. Die Umwandlung in etwas Älteres ist der verlässliche Weg daran vorbei, und dafür gibt es den Rest dieser Website.

Im Browser öffnen

Kein Browser liest es.

Das ist der häufigste Grund, es umzuwandeln: nicht dass das Format schlecht wäre, sondern dass die Stelle, an der die Datei erscheinen soll, es nicht lesen kann.

Es ist ein Arbeitsformat

TOML ist zum Öffnen und Ändern gedacht. Behalte die Datei in diesem Format, solange die Arbeit läuft, und exportiere daraus, wann immer eine fertige Fassung gebraucht wird.

Die Eckdaten auf einen Blick

Kennungen und Herkunft des Formats TOML.
Endung.toml
Medientypapplication/toml
Erstmals veröffentlicht2013
SpezifikationTOML 1.0

TOML in etwas anderes umwandeln

Etwas anderes in TOML umwandeln

Formate, die statt TOML infrage kommen