What JSON is
JSON is a text format for nested data: objects with named keys, arrays, strings, numbers, booleans and null. It has no date type and no comments.
Every web API, most configuration files and anything that talks to JavaScript.
What YAML is
YAML uses indentation instead of brackets. It is a superset of JSON, supports comments, and is meant to be edited by hand.
Kubernetes manifests, CI pipelines, Ansible playbooks and most modern config files.
What changes when you convert JSON to YAML
Four shapes all read correctly: an array of objects, an array of arrays with a header row, an object of column arrays, and an object keyed by row id. A single wrapper key holding the array, which is how most APIs reply, is unwrapped automatically. Nested objects are flattened one level into dotted keys; anything deeper is kept as JSON text in the cell, because a table cannot hold a tree.
You get a list of maps, one per row, with long lines left unwrapped so values do not get folded across lines.
Brackets and braces become indentation. YAML is a superset of JSON, so nothing is lost in the direction JSON to YAML. Every valid JSON document is already valid YAML; what changes is that it becomes readable.
Keys are written bare where they can be and quoted where they cannot. A key with a colon or a leading digit in it gets quotes, because leaving them off would change what it means.
Long values are left on one line rather than folded. Folded scalars are legal and they are also the fastest way to introduce a whitespace bug into a config file.
What carries over from JSON to YAML
YAML can express everything JSON holds about a table, so this conversion is about shape rather than loss.
Both formats record types, so numbers, booleans and nulls survive as themselves rather than as text.
The identifier 007 comes out of the YAML as 007. Reading it as a number would have made it 7, and an id that changes value is worse than one that stays text.
The role "Analyst, data" survives with its comma, in one cell rather than split across two. That is the first thing to check in any converted table, and the usual place a YAML file goes wrong.
The quotes around Jonah "Jo" Pryce are left as a plain quote character in the YAML.