Darmowy konwerter

JSON do Konwerter YAML

Konwertuj strukturę JSON na czysty format YAML. Idealny do manifestów Kubernetes i konfiguracji chmury.

Lub

O tym narzędziu

Przejście z JSON na YAML polega głównie na tym, aby dane były bardziej czytelne dla ludzi. Obydwa formaty opisują te same rodzaje struktur — obiekty/mapy, tablice/sekwencje, skalary — ale składnia YAML oparta na wcięciach, opcjonalne cytowanie i obsługa komentarzy ułatwiają ręczne skanowanie i edycję. Pliki konfiguracyjne to kanoniczny przypadek użycia: manifesty Kubernetesa, przepływy pracy CI, podręczniki Ansible i dziesiątki innych narzędzi wybrały YAML właśnie dlatego, że ich głównymi redaktorami są ludzie.

Ten konwerter używa js-yaml do serializacji przeanalizowanego obiektu JSON do YAML. Wynik zachowuje strukturę danych dokładnie przy zastosowaniu konwencji YAML: wcięcia dla zagnieżdżenia, listy dla tablic, pary klucz-wartość dla właściwości obiektu. Ścisłe podwójne cytowanie JSON zostało złagodzone; w wynikach cytowane są tylko ciągi znaków zawierające znaki specjalne lub wyglądające jak inne typy.

Konwersja zachowuje informacje, z wyjątkiem sytuacji, gdy YAML dodaje wyrazistości, której nie ma JSON. Nie można zrekonstruować komentarzy (w JSON ich nie było). Odniesienia do kotwic i aliasów mogą potencjalnie kompresować powtarzające się struktury, ale nie są generowane automatycznie; dane wyjściowe rozwijają wszystkie odniesienia wbudowane.

Po co konwertować JSON na YAML

YAML jest znacznie bardziej czytelny niż JSON dla konfiguracji edycji edytowanej przez ludzi. Wcięcia zastępują zagnieżdżanie nawiasów klamrowych, cudzysłowy są opcjonalne w przypadku prostych ciągów, a komentarze mogą dokumentować nieoczywiste ustawienia. W przypadku plików obsługiwanych przez ludzi — konfiguracji aplikacji, infrastruktury jako kodu, tworzenia potoków — YAML jest prawie zawsze właściwym formatem docelowym.

Nowoczesne narzędzia infrastrukturalne w przeważającej mierze faworyzują YAML. Kubernetes, Helm charts, Ansible, GitHub Actions, GitLab CI, Docker Compose i wiele innych narzędzi preferuje lub wymaga YAML. Konwersja eksportu JSON z jednego systemu na konfigurację YAML dla innego jest rutynowym krokiem integracji.

Jak używać

Wklej JSON, pobierz YAML.

  1. Dodaj swój JSON: Wklej tekst JSON lub upuść plik. Dane wejściowe muszą być prawidłowym kodem JSON; konwerter nie próbuje analizować danych wejściowych typu JSON, które naruszają specyfikację.
  2. Wybierz opcje: Domyślny rozmiar wcięcia to 2 spacje, co jest najczęstszą konwencją YAML. Styl przepływu (kompaktowy, podobny do JSON) w porównaniu ze stylem blokowym (opartym na wcięciach) przełącza wygląd wyjściowy — blok jest domyślnym, przyjaznym dla człowieka ustawieniem.
  3. Konwertuj: Funkcja zrzutu js-yaml serializuje przeanalizowane drzewo JSON do YAML. Cytowanie ciągów znaków jest stosowane tylko tam, gdzie jest to konieczne; złożone ciągi znaków pozostają czytelne.
  4. Pobierz lub skopiuj: Zapisz jako .yml lub skopiuj do schowka. Dane wyjściowe są prawidłowe w formacie YAML 1.2 i są gotowe dla dowolnego konsumenta YAML.

Typowe przypadki użycia

Szczegóły techniczne

Funkcja dump js-yaml przegląda drzewo obiektów JavaScript i emituje YAML przy użyciu konfigurowalnego formatowania. Głębokość wcięcia, szerokość linii, próg stylu przepływu i obsługa cytatów to parametry. Domyślne ustawienia tworzą YAML w stylu blokowym z wcięciem 2-spacyjnym, co jest najczęstszą konwencją.

Cytowanie ciągów znaków jest zgodne z regułami YAML: ciągi znaków, które wyglądają podobnie do innych typów (liczby, wartości logiczne, wartość null, daty) są cytowane, aby wymusić interpretację ciągów; ciągi zawierające znaki specjalne (dwukropki, skróty, myślniki początkowe) są cytowane; proste ciągi alfabetyczne pozostawia się bez cudzysłowu.

Dane wyjściowe są kompatybilne z YAML 1.2 i można je łatwo analizować za pomocą js-yaml, PyYAML i innych głównych bibliotek YAML. Idempotentne podróże w obie strony (JSON → YAML → JSON) zachowują dane, chociaż reprezentacja YAML wybiera formatowanie kanoniczne, które może różnić się od odpowiednika pisanego ręcznie.

Najlepsze praktyki

Często zadawane pytania

Czy konwersja JSON na YAML zmienia treść?
Treść jest zachowywana tak dokładnie, jak to możliwe. Jednak niektóre funkcje specyficzne dla formatu mogą nie mieć bezpośrednich odpowiedników, dlatego mogą wystąpić drobne różnice w formatowaniu.
Dlaczego warto używać formatu YAML?
YAML jest popularny w przypadku plików konfiguracyjnych, ponieważ jest bardzo czytelny przy minimalnej składni. Jest to standard dla Docker Compose, Kubernetes, GitHub Actions i wielu narzędzi CI/CD.
Czy konwerter obsługuje zagnieżdżone lub złożone struktury JSON?
Tak. Narzędzie poprawnie analizuje zagnieżdżone obiekty, tablice i wszystkie standardowe typy danych JSON, zachowując pełną strukturę danych w wynikach YAML.
Czy ta konwersja jest bezpieczna i prywatna?
Tak. Całe przetwarzanie odbywa się lokalnie w Twojej przeglądarce. Twoje dane nigdy nie opuszczają Twojego urządzenia — bez przesyłania na serwer, bez przetwarzania w chmurze, bez gromadzenia danych.
A co z ciągami znaków ze znakami specjalnymi?
js-yaml cytuje je automatycznie. Ciągi znaków zawierające dwukropki, skróty lub myślniki początkowe są zawijane w cudzysłowy, aby zachować poprawny format YAML.
Czy moje dane są przesyłane na serwer?
Nie. Konwersja odbywa się w Twojej przeglądarce przy użyciu js-yaml.
Czy mogę podróżować JSON w obie strony do YAML i z powrotem?
Tak. JSON → YAML → JSON zachowuje dane strukturalnie. Kolejność kluczy przekonwertowanej JSON jest zgodna z danymi wejściowymi.
Jaki jest maksymalny rozmiar wejściowy?
Do 50MB. js-yaml natychmiast obsługuje typowe pliki konfiguracyjne.