How To Work With Toml

The basics

A table is a set of key/value pairs. Three ways to declare:

Scalar types

All three produce the same logical structure. Pick one style per file for readability.

Tables

Double-bracket headers define array elements, each its own table:

Nested tables

Most tools (including our converter) parse TOML into an internal object, then serialize to JSON. Clean for most data; datetimes may need special handling.

Arrays of tables

TOML vs JSON vs YAML

TOML version differences

Comments

Round-trip preservation

Common gotchas

TOML to JSON and back

When to pick TOML

Common mistakes

Run the numbers