Konwerter JSON na YAML

Jak korzystać z konwertera JSON na YAML

1. Wybierz kierunek: JSON → YAML lub YAML → JSON.
2. Wklej dane albo kliknij Otwórz plik, aby wczytać plik .json, .yaml lub .yml (do 10 MB).
3. Wybierz Wcięcie (2 lub 4 spacje) i, jeśli chcesz, zaznacz Sortuj klucze, aby uporządkować je alfabetycznie.
4. Kliknij Konwertuj albo po prostu pisz dalej: wynik aktualizuje się automatycznie. Jeśli dane wejściowe są niepoprawne, komunikat błędu podaje wiersz i kolumnę problemu.
5. Skopiuj lub pobierz wynik. Odwróć kierunek przenosi wynik z powrotem do pola wejściowego, aby przekonwertować go w drugą stronę.

JSON i YAML: te same dane, inna składnia

W praktyce YAML jest nadzbiorem JSON: każde dane zapisane w JSON da się wyrazić w YAML, a YAML dodaje lżejszą składnię, łatwiejszą do czytania i edycji przez ludzi. Dlatego manifesty Kubernetes, pliki Docker Compose, GitHub Actions i potoki GitLab CI, playbooki Ansible oraz specyfikacje OpenAPI zwykle pisze się w YAML, a API i programy wymieniają się JSON-em.

Te same dane w obu formatach:

{"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}

name: web
ports:
  - 80
  - 443
env:
  DEBUG: false

JSON → YAML

Konwerter zapisuje YAML w stylu blokowym: jeden klucz w wierszu, listy z myślnikami i wcięte zagnieżdżone obiekty. Długie ciągi nigdy nie są zawijane, a ciągi wielowierszowe używają stylu dosłownego |, dzięki czemu znaki nowego wiersza są zachowane dokładnie. Ciągi, które YAML odczytałby jako inny typ, są ujmowane w cudzysłowy: "yes", "1.0" czy "null" pozostają ciągami po konwersji w obie strony. Sortuj klucze porządkuje alfabetycznie klucze każdego obiektu, co ułatwia porównywanie dwóch plików konfiguracyjnych.

YAML → JSON

YAML jest odczytywany według schematu core YAML 1.2 – tych samych reguł, których używa większość nowoczesnych narzędzi:

• true/false, liczby i null (lub ~) stają się wartościami JSON; yes, no, on i off pozostają ciągami, zgodnie ze specyfikacją YAML 1.2.
• Kotwice i aliasy (&base, *base) są rozwijane, a klucze scalające (<<: *base), częste w plikach CI, są obsługiwane.
• Plik z kilkoma dokumentami rozdzielonymi --- staje się tablicą JSON z jednym elementem na dokument, a komunikat informuje, ile dokumentów połączono.
• Komentarze są pomijane, bo JSON nie ma komentarzy.
• .inf i .nan nie mają odpowiednika w JSON; są zapisywane jako ciągi "Infinity" i "NaN".

Aby chronić przeglądarkę przed plikami typu „billion laughs”, w których kilka aliasów rozwija się w miliardy wartości, dokument rozwijający się do ponad miliona wartości jest odrzucany.

Częste błędy w YAML

• Tabulatory we wcięciach: YAML dopuszcza wyłącznie spacje.
• Niespójne wcięcia: elementy tej samej listy lub obiektu muszą zaczynać się w tej samej kolumnie.
• Brak spacji po dwukropku: key:value to pojedynczy ciąg, a key: value to para klucz–wartość.
• Znaki specjalne bez cudzysłowów: wartość zaczynająca się od @, odwróconego apostrofu, *, & lub ! albo zawierająca : lub # musi być ujęta w cudzysłowy.