TOML zu JSON Konverter

Was ist TOML und warum nach JSON konvertieren?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Hauptfunktionen

Beispiele

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

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

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Anleitung

1. 1

   TOML einfügen

   Geben Sie Ihr TOML in das Eingabefeld oben ein oder fügen Sie es ein. Sie können auch auf 'Beispiel laden' klicken, um eine echte Cargo.toml, pyproject.toml oder Deployment-Konfiguration auszuprobieren.

2. 2

   Live-JSON-Ausgabe sehen

   JSON erscheint sofort im Ausgabebereich. Passen Sie die Einrückungsoption (2 oder 4 Leerzeichen) an Ihr Zielformat an. Datumsangaben, Tabellen und Tabellen-Arrays werden automatisch behandelt.

3. 3

   Kopieren oder herunterladen

   Klicken Sie auf Kopieren, um das JSON in die Zwischenablage zu übernehmen, oder auf Herunterladen, um es als .json-Datei zu speichern, bereit für Ihr Programm, Ihre API oder Ihr Tooling.

Häufige TOML-Fallstricke

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Häufige Anwendungsfälle

Rust-Cargo-Metadaten

Konvertieren Sie Cargo.toml nach JSON, um Abhängigkeits-Dashboards zu erstellen, Crate-Versionen und -Features zu prüfen oder Manifest-Daten in Skripte und CI einzuspeisen, die JSON statt TOML erwarten.

Python-Projektkonfiguration

Konvertieren Sie pyproject.toml nach JSON, um PEP-621-Projekt-Metadaten zu prüfen, Abhängigkeitslisten zu extrahieren oder Tooling zu steuern, das die Packaging-Konfiguration programmatisch liest.

Deployment-Konfiguration prüfen

Konvertieren Sie netlify.toml, foundry.toml oder andere Plattform-Konfigurationen nach JSON, um Weiterleitungen, Header und Build-Einstellungen zu prüfen oder eine äquivalente Konfiguration für eine andere Plattform zu erzeugen.

Migration des Konfigurationsformats

Konvertieren Sie TOML-Anwendungskonfiguration nach JSON, wenn Sie zu einem System wechseln, das JSON bevorzugt, oder als Zwischenschritt, bevor Sie mit JSON-Werkzeugen wie jq weiter transformieren.

Einstellungen für statische Websites

Konvertieren Sie Hugo-config.toml nach JSON, um Website-Einstellungen zu migrieren, Konfigurationen über Umgebungen hinweg zu vergleichen oder eine JSON-gestützte Einstellungsoberfläche zu erstellen.

API- und Skript-Eingabe

Verwandeln Sie von Menschen verfasstes TOML in JSON, das eine REST-API, eine Serverless-Funktion oder ein Automatisierungsskript direkt verarbeiten kann, und schlagen Sie so die Brücke zwischen gut lesbarer Konfiguration und Maschineneingabe.

Technische Details

TOML-1.0.0-Parsing über smol-toml

TOML wird mit der smol-toml-Bibliothek geparst, einem abhängigkeitsfreien, vollständig TOML-1.0.0-konformen Parser. Er verarbeitet verschachtelte Tabellen, punktierte Schlüssel, Inline-Tabellen, Tabellen-Arrays, mehrzeilige Strings und alle vier Datums-/Zeittypen korrekt und meldet Parse-Fehler mit Zeilen- und Spaltenpositionen.

Verlustfreie Datums-/Zeit- und sichere Ganzzahl-Behandlung

TOML-Datums-/Zeitwerte werden zu JSON-Strings serialisiert, die ihre exakte Art bewahren (Offset-Datum-Zeit, lokales Datum-Zeit, lokales Datum, lokale Zeit). Ganzzahlen außerhalb des sicheren JavaScript-Bereichs (2^53 - 1) werden beim Parsen zu BigInt hochgestuft und dann mit einer Präzisionswarnung in die nächstgelegene JSON-Zahl umgewandelt, sodass gültiges TOML nie an der Konvertierung scheitert.

100% browserbasiert — kein Upload, kein Server

Die gesamte Verarbeitung findet in der JavaScript-Engine Ihres Browsers statt. Zu keinem Zeitpunkt werden Daten übertragen. Eingaben über 200 KB wechseln vom Live- in den manuellen Modus (ein expliziter Klick auf Konvertieren), damit die Oberfläche reaktionsfähig bleibt.

Bewährte Praktiken

Sehr große Ganzzahlen als Strings speichern

Wenn Ihr TOML Ganzzahlen über 2^53 - 1 enthält (Snowflake-IDs, Nanosekunden-Zeitstempel, große Zähler), setzen Sie sie vor der Konvertierung als Strings in Anführungszeichen. JSON-Zahlen im Browser können sie nicht exakt halten, und das Tool warnt Sie, wenn es runden muss.

2-Leerzeichen-Einrückung für die JSON-Ausgabe bevorzugen

Zwei-Leerzeichen-Einrückung ist die am weitesten verbreitete Konvention für JSON und erzeugt eine saubere, gut lesbare Ausgabe, die mit den meisten Formatierern und Diff-Werkzeugen gut zusammenspielt. Reservieren Sie die 4-Leerzeichen-Einrückung für Fälle, in denen eine Stilrichtlinie sie verlangt.

Die JSON-Ausgabe vor der Verwendung validieren

Wenn Sie nach der Konvertierung das JSON von Hand bearbeiten oder in ein striktes System einspeisen möchten, prüfen Sie es mit unserem JSON Formatierer, um sicherzustellen, dass es gültig und einheitlich formatiert ist.

TOML-Kommentare separat aufbewahren

JSON kennt keine Kommentarsyntax, daher werden TOML-#-Kommentare bei der Konvertierung verworfen. Wenn die Kommentare wichtige Dokumentation sind, bewahren Sie das ursprüngliche TOML in der Versionsverwaltung neben dem erzeugten JSON auf.

Tabellen-Arrays für wiederholte Abschnitte verwenden

Wenn Sie mehrere ähnliche Abschnitte haben (Server, Weiterleitungen, Bins), schreiben Sie sie als Tabellen-Arrays ([[section]]), anstatt [section] zu wiederholen. Sie werden zu einem sauberen JSON-Array von Objekten konvertiert, statt einen Fehler wegen doppelter Tabellen zu verursachen.

Häufig gestellte Fragen