HN Hall of Fame Weekly email

TOML: Tom's Obvious Minimal Language

Screenshot of toml.io captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 5 calendar years, with breakout response in 2 of them.

submissions
6
submitters
6
observed span
2020–2026
peak thread · 221 comments
165 pts
latest 20+ return · 2023-05-21
165 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

JSON is basically perfect if it allowed trailing commas and comments. TOML is not a replacement for JSON because of how badly it chokes on nested lists of objects (being both hard to read and hard to write), due to a misguided attempt to avoid becoming JSON-like[1]. [1] https://github.com/toml-lang/toml/issues/516

SPBS·165-point thread·

TOML superficially looks clean, but it has many of the same problems other similar languages have. Such file formats are typically used for configuration files. Yet, a substantial amount of effort was expended on data types not commonly seen in configuration files, such as a date-time-offset. Meanwhile, much more common data types typically used in configuration files is missing, such as GUIDs, IP Addresses, and byte arrays. Most disappointingly, TOML has a "table" type, but unfortunately, just like other "RPC…

I tried to use toml in as config format for the app I am building at my day job. I ditched it for json because it's representation is not unambiguous, meaning the same object tree has many many different valid representations in toml. This makes it really hard to implement roundtripping of the config string to object tree and then back to config string without losing the specific toml representation chosen by the config author and no library that I've…

b4ckup·10-point thread·

Popular in: 2023 (165 points, 224 comments) https://news.ycombinator.com/item?id=36018817 2020 (146 points, 160 comments) https://news.ycombinator.com/item?id=24436550

gnabgib·1-point thread·

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
2

100+ points or 50+ comments

Total points
328

reference only — not used in Hall rules or ranking

Total comments
394

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2020-09-10TOML – Tom's Obvious, Minimal LanguageFirst breakoutpmoriarty146160
2023-05-21TOML: Tom's Obvious Minimal LanguageBest thread · Latest 20+ point returnjonbaer165221
2024-08-31TOML: Tom's Obvious Minimal Languagebundie30
2024-10-29TOML: A config file format for humanshandfuloflight11
2025-02-18TOML [Tom's Obvious Minimal Language]Hall inductionwanderer23231012
2026-05-07TOML: A config file format for humansthunderbong30