Home/File Formats/TOML
File Format Wiki

TOML format rules

Configuration format used by Rust, Python, Netlify, and Wrangler.

Format rules

  • Tables use [name]
  • Strings are quoted
  • Dates and arrays have strict syntax

Valid example

name = "easytool"
[build]
command = "npm run build"

Invalid example

[build
command = npm run build

Common errors

  • Assuming TOML accepts syntax from a similar format
  • Using the wrong encoding or line ending
  • Copying invisible characters from rich text
  • Testing only the happy path and not parser errors

Online validation and conversion

Compared with nearby formats

TOML should be chosen for the parser and ecosystem that will consume it. Prefer strict formats for APIs, human-friendly formats for ops config, and signed formats only when verification is required.