A YAML könnyebb olvashatóságáról ismert, szemben az XML vagy JSON formátummal.
Minden YAML fájl egy listával kezdődik. A lista minden eleme kulcs-érték pár felépítésű. A YAML fájlt — karaktereket tartalmazó sorral kezdjük és … karaktereket tartalmazó sorral zárjuk, de ezek nem kötelezők.
A lista minden tagja ugyanabban az oszlopban elhelyezett „-” karakterrel van bevezetve.
Legyen itt egy példa:
--- # járművek - Lada - Ford - Audi - Dacia - Honda ...
Szótár
# bejegyzések - Jani név : Nagy János beosztás : fejlesztő képességek : - Python - Perl - PHP - Kati név : Permet Katalin beosztás : fejlesztő - C - C++ - C#