JSON en YAML kunnen dezelfde gegevenstypen vertegenwoordigen (objecten, arrays, strings, getallen), maar hun syntaxis verschilt: • JSON gebruikt accolades/haakjes en dubbele aanhalingstekens, heeft een striktere syntaxis en ondersteunt geen commentaar. • YAML gebruikt inspringing voor hiërarchie, is beter leesbaar voor mensen en ondersteunt commentaar, maar is gevoelig voor witruimte. Vuistregel: • Voor API's en machine-to-machine gegevensuitwisseling geeft u de voorkeur aan JSON. • Voor Kubernetes/Helm/CI-configuraties die vaak door mensen worden bewerkt, geeft u de voorkeur aan YAML. • U kunt ertussen converteren zonder het gegevensmodel te wijzigen.

Dit komt voort uit het verouderde YAML 1.1-gedrag, waarbij ja/nee/aan/uit/y/n kan worden geparseerd als booleans. Deze tool volgt YAML 1.2, waarbij alleen waar/onwaar booleaanse waarden zijn. Als u tekenreekswaarden nodig heeft, citeert u deze (bijvoorbeeld 'ja').

JSON (RFC 8259) staat geen opmerkingen toe. YAML-opmerkingen kunnen dus niet worden bewaard in YAML → JSON-conversie, en ze kunnen niet worden gereconstrueerd wanneer ze terug worden geconverteerd. Bewaar het originele YAML-bestand als opmerkingen ertoe doen.

--- is het documentscheidingsteken van YAML, dat wordt gebruikt om meerdere onafhankelijke documenten in één bestand op te slaan. Dit is gebruikelijk in Kubernetes, waar één bestand definities van Deployment, Service en ConfigMap kan bevatten. Deze tool leest YAML met meerdere documenten als een JSON-array, en kan een JSON-array ook weer splitsen in --- gescheiden YAML-documenten.

JavaScript maakt gebruik van IEEE 754-getallen met dubbele precisie. Veilige gehele getallen variëren van -(2^53-1) tot 2^53-1 (±9007199254740991). Grotere gehele getallen (bijvoorbeeld Snowflake-ID's of 64-bits tijdstempels) kunnen hun nauwkeurigheid verliezen. Om exacte waarden te behouden, slaat u ze op als tekenreeksen, zoals '9007199254740992'.