JSON i YAML mogą reprezentować te same typy danych (obiekty, tablice, ciągi znaków, liczby), ale ich składnia jest inna: • JSON używa nawiasów klamrowych/nawiasów i podwójnych cudzysłowów, ma bardziej rygorystyczną składnię i nie obsługuje komentarzy. • YAML wykorzystuje wcięcia w hierarchii, jest bardziej czytelny dla człowieka i obsługuje komentarze, ale jest wrażliwy na białe znaki. Ogólna zasada: • W przypadku interfejsów API i wymiany danych między maszynami preferuj JSON. • W przypadku konfiguracji Kubernetes/Helm/CI, które często edytują ludzie, preferuj YAML. • Można konwertować między nimi bez zmiany modelu danych.

Wynika to ze starszego zachowania YAML 1.1, gdzie tak/nie/włączone/wyłączone/t/n może być analizowane jako wartości logiczne. To narzędzie jest zgodne z YAML 1.2, gdzie tylko prawda/fałsz są wartościami logicznymi. Jeśli potrzebujesz wartości ciągu, podaj je (na przykład „tak”).

JSON (RFC 8259) nie pozwala na komentarze. Zatem komentarzy YAML nie można zachować w konwersji YAML → JSON i nie można ich zrekonstruować podczas konwersji z powrotem. Jeśli komentarze mają znaczenie, zachowaj oryginalny plik YAML.

--- to separator dokumentów YAML, używany do przechowywania wielu niezależnych dokumentów w jednym pliku. Jest to powszechne w Kubernetes, gdzie jeden plik może zawierać definicje wdrożenia, usługi i ConfigMap. To narzędzie odczytuje wielodokumentowy plik YAML jako tablicę JSON, a także może podzielić tablicę JSON z powrotem na --- oddzielone dokumenty YAML.

JavaScript używa liczb o podwójnej precyzji IEEE 754. Bezpieczne liczby całkowite mieszczą się w zakresie od -(2^53-1) do 2^53-1 (±9007199254740991). Większe liczby całkowite (na przykład identyfikatory płatków śniegu lub 64-bitowe znaczniki czasu) mogą utracić precyzję. Aby zachować dokładne wartości, przechowuj je jako ciągi znaków, na przykład „9007199254740992”.