TOML aims to be a minimal configuration file format that’s easy to read due to obvious semantics.
TOML is designed to map unambiguously to a hash table. TOML should be easy to parse into data structures in a wide variety of languages.
TOML shares traits with other file formats used for application configuration and data serialization, such as YAML and JSON. TOML and JSON both are simple and use ubiquitous data types, making them easy to code for or parse with machines. TOML and YAML both emphasize human readability features, like comments that make it easier to understand the purpose of a given line. TOML differs in combining these, allowing comments (unlike JSON) but preserving simplicity (unlike YAML).
Key Features
- TOML is case-sensitive.
- A TOML file must be a valid UTF-8 encoded Unicode document.
- Whitespace means tab (0x09) or space (0x20).
- Newline means LF (0x0A) or CRLF (0x0D 0x0A).
- Useful native types:
- Key/Value Pairs.
- Arrays.
- Tables.
- Inline tables.
- Arrays of tables.
- Integers & Floats.
- Booleans.
- Dates & Times, with optional offsets.
- Wide support – implementations for most of the most popular programming languages in use today: C, C#, C++, Clojure, Dart, Elixir, Erlang, Go, Haskell, Java, JavaScript, Lua, Objective-C, Perl, PHP, Python, Ruby, Rust, Scala, Swift, and more.
Website: toml.io
Support: GitHub Code Repository
Developer: Tom Preston-Werner
License: MIT License
Related Software
| Lightweight Markup Languages | |
|---|---|
| Markdown | Markup language and Text-to-HTML conversion tool |
| MultiMarkdown | Based on Markdown with additional features |
| GitHub Flavored Markdown | For user content on GitHub.com and GitHub Enterprise |
| Markdown Extra | Lightweight markup language based on Markdown |
| AsciiDoc | Presentable text document format for writing articles |
| Textile | Billed as a "humane web text generator" |
| Texy | Text-to-XHTML formatter and converter library |
| Tome | Markup Language and Tool Suite for Authors |
| reStructuredText | Markup Syntax and Parser Component of Docutils |
| Haml | Templating engine for HTML |
| JsonML | Map between XML and JSON |
| TOML | Tom’s Obvious Minimal Language |
| Djot | Light markup language inspired by CommonMark |
| Org-mode | Plain text markup for notes, documents, and workflows |
Explore our carefully curated directory of recommended free and open source software, covering every major software category.The directory forms part of our extensive collection of articles for Linux enthusiasts. It includes hundreds of detailed reviews, together with free and open source alternatives to proprietary software from companies such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. LinuxLinks also covers interesting projects worth exploring, Linux-compatible hardware, free programming books and tutorials, and much more. Know a useful free and open source Linux application that we haven’t covered? Tell us about it using our submission form. |


Please read our Comment Policy before commenting.