What is a YAML file?
YAML — human-readable configuration
What is it?
YAML is a configuration format designed to be read and written by humans. No braces, no tags: structure is conveyed through indentation, much like a bulleted list.
It supports comments, which makes it the format of choice for configuration files — an area where JSON, which forbids them, is downright frustrating to work with.
History & origin
YAML appeared in 2001, with the explicit goal of being more readable than XML and more flexible than existing configuration formats.
It has since become a fixture of modern development tooling: continuous integration, container orchestration, automated deployment. Any engineer today writes it on a daily basis.
Why it is useful
Highly readable and concise, it supports comments and handles nested structures with elegance.
It is technically a superset of JSON: any valid JSON file is also valid YAML.
Limits & drawbacks
Indentation is meaningful, and tabs are forbidden: a single misplaced or extra space can change a file's meaning or render it invalid.
Its automatic type conversions are a well-known trap: in older versions, the value NO — the country code for Norway — was interpreted as the boolean "false". This kind of surprise has earned the format a reputation for ambiguity.
Practical tips
YAML is ideal for hand-written configuration. For machine-to-machine data exchange, convert it to JSON: stricter, more predictable, and free of type ambiguity.
Always quote values that could be misinterpreted: yes, no, on, off, and anything that looks like a number without actually being one.
Convert your YAML in seconds, on our secure servers in France.
Convert a YAML