Loading…

Über Online TOML-Formatierer

Unordentliche `pyproject.toml`, `Cargo.toml` oder `poetry`-Konfigurationen? Fügen Sie Ihre TOML-Daten ein oder legen Sie eine Datei ab, und unser Formatierer normalisiert Leerzeichen, räumt Arrays und Inline-Tabellen auf und hält Ihre Abschnitte konsistent beabstandet. Ideal für Python, Rust, Go, Static-Site-Generatoren und jedes Projekt, das auf TOML für die Konfiguration setzt.

Hauptfunktionen des TOML-Formatierers

  • **Ein-Klick-Verschönerer** für TOML-Konfigurationsdateien und -ausschnitte
  • **Konfigurierbare Einrückungsgröße** von 1 bis 8 Leerzeichen über den *Einrückungsgröße*-Schieberegler
  • **Einrückungsstil-Umschalter** – wählen Sie zwischen Leerzeichen oder Tabulatoren für die Einrückung
  • **Umbruch / Zeilenlänge**-Steuerung, um lange Arrays und Inline-Tabellen innerhalb einer gewählten Spaltenbreite zu halten
  • Unterstützt `.toml`-Dateien wie `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` und mehr
  • Prettier-basierter TOML-Parser, der Daten, Arrays, verschachtelte Tabellen und Inline-Tabellen versteht
  • Stabile, idempotente Formatierung – erneutes Ausführen auf derselben Datei verursacht keine Formatierungsabweichung
  • Ein-Klick-Kopieren der formatierten Ausgabe, bereit für Ihren Editor oder Commit

🛠️ So formatieren Sie TOML-Dateien online for toml-formatter

1

1. Fügen Sie Ihr TOML ein oder laden Sie es hoch

📥 Fügen Sie TOML in den Editor ein oder ziehen Sie eine `.toml`-Datei wie `pyproject.toml` oder `Cargo.toml` per Drag-and-Drop hinein. Das Tool analysiert den Inhalt als TOML, nicht als generisches INI/JSON.

2

2. Wählen Sie Einrückung & Umbruch-Einstellungen

⚙️ Verwenden Sie den **Einrückungsgröße**-Schieberegler, um die Anzahl der Leerzeichen pro Einrückungsebene zu wählen, und schalten Sie **Einrückungsstil** auf Tabulatoren um, wenn Ihr Projekt diese bevorzugt. Passen Sie **Umbruch / Zeilenlänge** an, um zu steuern, wann lange Arrays oder Inline-Tabellen umbrechen sollen (oder setzen Sie es auf `0`, um den Umbruch effektiv zu deaktivieren).

3

3. Klicken Sie auf „Formatieren“

🚀 Drücken Sie die **Formatieren**-Schaltfläche. Der Formatierer wird Arrays umbrechen, Abstände um `=` und Kommas bereinigen, Tabellenabstände normalisieren und konsistente Zeilenumbrüche durchsetzen, während Ihre Daten erhalten bleiben.

4

4. Überprüfen, Kopieren oder Speichern

🔍 Vergleichen Sie das ursprüngliche und das formatierte TOML. Wenn Sie zufrieden sind, kopieren Sie das Ergebnis zurück in Ihren Editor oder speichern Sie es als neue `.toml`-Datei in Ihrem Projekt.

Technische Spezifikationen

Unterstützte TOML-Funktionen

Der Formatierer ist für reale Projektkonfigurationen entwickelt und versteht moderne TOML-Konstrukte.

FunktionUnterstützungBeispiele / Hinweise
Tabellen & Untertabellen✅ Vollständig[tool.poetry], [project], [database.replica]
Arrays✅ VollständigInline-Arrays und Arrays von Tabellen
Inline-Tabellen✅ Vollständigserver = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Daten & Zeiten✅ Vollständig2025-09-23T10:20:30Z und lokale Datumsformate
Kommentare✅ Beibehalten# Kommentare bleiben in der Nähe der beschriebenen Einstellungen
Mehrzeilige Zeichenketten✅ VollständigDreifach-gekennzeichnete TOML-Zeichenketten für lange Textblöcke

Formatierungsoptionen (Zu Werkzeugsteuerungen zugeordnet)

Diese Optionen sind direkt in der Benutzeroberfläche verfügbar und mit dem zugrunde liegenden Prettier-TOML-Plugin verbunden:

OptionUI-SteuerungBereich / WerteStandard
EinzugsgrößeEinzugsgröße-Schieberegler1–8 Leerzeichen2 Leerzeichen
EinzugsstilEinzugsstil-AuswahlLeerzeichen / TabsLeerzeichen
ZeilenhöheUmbruch / Zeilenlänge0–120 Spalten (0 = effektiv kein Umbruch)80 Spalten
ZeilenendeZeilenende (intern)LF / CRLFLF in Browserausgabe

Eingabe & Grenzen

Das Werkzeug ist für kleine bis mittlere TOML-Dateien optimiert, die häufig in Anwendungs-Repositories vorkommen.

ParameterWert / VerhaltenHinweise
Dateierweiterungen.tomlBeliebige TOML-basierte Konfigurationsdatei
MIME-Typenapplication/toml, text/x-tomlWird zur Dateierkennung in der Dropzone verwendet
Maximale Dateigröße~5 MBGrößere Dateien können langsamer sein und werden besser in der CI verarbeitet
Maximale Zeichen≈ 2.000.000Harte Grenze in der Laufzeit des Formatierers, um Browser-Abstürze zu vermeiden

Validierung & Fehlerbehandlung

Wenn Ihre Datei kein gültiges TOML ist (z.B. fehlendes `=` oder nicht übereinstimmende Anführungszeichen), gibt der Formatierer normalerweise eine lesbare Fehlermeldung statt formatierten Outputs zurück. Korrigieren Sie die angezeigte Zeile und führen Sie den Formatierer erneut aus.

Kommandozeilen-Alternativen für TOML-Formatierung

Gefällt Ihnen das Ergebnis und möchten Sie denselben Stil in CI oder Pre-Commit-Hooks? Hier sind CLI-freundliche Optionen:

Plattformübergreifend (Node.js / Prettier)

Prettier und das TOML-Plugin installieren

npm install --save-dev prettier prettier-plugin-toml

Fügt Prettier und den TOML-Parser zu Ihrem Projekt hinzu.

Eine TOML-Datei mit Prettier formatieren

npx prettier --parser toml --write pyproject.toml

Überschreibt `pyproject.toml` direkt mit Prettiers TOML-Regeln.

Linux / macOS / Windows (Taplo CLI)

TOML mit Taplo formatieren

taplo fmt pyproject.toml

Ein weiterer beliebter CLI-Formatierer für TOML-Dateien.

Formatierung in der CI prüfen

taplo fmt --check .

Lässt den Build fehlschlagen, wenn TOML-Dateien nicht korrekt formatiert sind.

Verwenden Sie dieses Online-Tool für schnelle Bearbeitungen und Experimente, und setzen Sie dann denselben Stil mit Prettier oder Taplo in Ihren CI-Pipelines durch.

Häufige Anwendungsfälle für TOML-Formatierer

Python-Packaging (`pyproject.toml`)

Halten Sie Python-Projektmetadaten und Tool-Konfiguration sauber und leicht überprüfbar.

  • Richten Sie `[project]`, `[tool.poetry]` und `[tool.black]` Abschnitte aus.
  • Normalisieren Sie Abhängigkeitsarrays und Versionsspezifikationen.
  • Machen Sie Konfigurationsunterschiede in Pull-Requests leichter lesbar.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Rust-Projekte (`Cargo.toml`)

Ordnen Sie Rust-Paketmanifeste in Workspaces und Microservices.

  • Halten Sie `[dependencies]` und `[dev-dependencies]` sortiert und einheitlich beabstandet.
  • Normalisieren Sie Inline-Tabellen für komplexe Feature-Flags.
  • Standardisieren Sie die Formatierung über mehrere Crates in einem Workspace hinweg.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Statische Websites & Tools (Hugo, Zola, etc.)

Bereinigen Sie TOML, das für Static-Site-Generatoren und verschiedene Tools verwendet wird.

  • Formatieren Sie `config.toml` für Hugo oder andere Static-Site-Generatoren.
  • Halten Sie mehrsprachige Konfigurationsblöcke lesbar.
  • Normalisieren Sie lange Listen wie Menüeinträge und Taxonomien.

❓ Frequently Asked Questions

❓Was ist ein TOML-Formatter?

Ein TOML-Formatter strukturiert Ihre TOML-Dateien automatisch neu, sodass sie einem einheitlichen Stil folgen: Er korrigiert Einrückungen, richtet Arrays und Inline-Tabellen aus, normalisiert Leerzeichen um `=` und Kommas und erhält die Daten, während sie leichter lesbar und überprüfbar werden.

📏Wie sollte ich Einrückungsgröße und Stil wählen?

Wenn Ihr Team keine Präferenz hat, sind **2 Leerzeichen** eine gute Standardeinstellung. Passen Sie den Stil an, der bereits in Ihrem Repo verwendet wird: Wenn Dateien meist mit Leerzeichen eingerückt sind, verwenden Sie weiterhin Leerzeichen; wenn Tabs der Teamstandard sind, wechseln Sie den **Einrückungsstil** zu Tabs, damit neue Änderungen mit dem bestehenden Code übereinstimmen.

🧪Validiert der Formatter die TOML-Syntax?

Der zugrunde liegende Parser lehnt ungültiges TOML ab (z. B. fehlendes `=` oder nicht übereinstimmende Anführungszeichen). In diesem Fall zeigt das Tool eine Fehlermeldung anstelle der formatierten Ausgabe an, sodass Sie das Problem beheben und es erneut versuchen können.

🔁Kann das Ausführen des Formatters mein Konfigurationsverhalten ändern?

Der Formatter ist so konzipiert, dass er **semantikerhaltend** ist: Er ändert nur Leerzeichen und Layout, nicht Schlüssel, Werte oder Tabellenstruktur. Solange die ursprüngliche Datei gültiges TOML ist, sollte die Bedeutung Ihrer Konfiguration gleich bleiben.

🔒Ist es sicher, sensible Konfigurationsdateien zu formatieren?

Wie bei jedem Online-Tool sollten Sie das Einfügen extrem sensibler Materialien wie Produktionsgeheimnisse vermeiden. Für hochvertrauliche Konfigurationen verwenden Sie einen lokalen TOML-Formatter (wie Prettier oder Taplo) in Ihrer privaten Entwicklungsumgebung.

Pro Tips

Best Practice

Halten Sie eine schön formatierte `pyproject.toml` oder `Cargo.toml` in Ihrem Hauptbranch, und erzwingen Sie dann denselben Stil in CI mit Prettier oder Taplo.

Best Practice

Formatieren Sie TOML, bevor Sie große Abhängigkeits- oder Konfigurationsänderungen committen, damit sich Ihre Git-Diffs auf **tatsächliche Änderungen** konzentrieren, nicht auf Leerzeichen-Rauschen.

Best Practice

Wenn Sie Konfigurationen refaktorisieren, formatieren Sie die Datei zuerst, committen Sie, und ändern Sie dann die Werte. Dies erleichtert die Überprüfung, was sich wirklich geändert hat.

Best Practice

Verwenden Sie in allen Ihren TOML-Dateien dieselbe **Einrückungsgröße** und **Zeilenlänge**, um die Navigation zwischen Projekten und Code-Reviews konsistent zu gestalten.

Additional Resources

TOML v1.0.0 Spezifikation
Technical specification
Prettier TOML Plugin
Documentation
Taplo – TOML Toolkit
Documentation

Other Tools