Question: how do yaml files work?
Answer: YAML is to configuration what markdown is to markup. It's basically a human-readable structured data format. It is less complex and ungainly than XML or JSON, but provides similar capabilities. ... Basically, the data you enter in a YAML file is used in conjunction with a library to create the pages you see within Grav.