Zdarma převodník

JSON do Převaděč YAML

Převeďte strukturu JSON na čistý formát YAML. Ideální pro manifesty Kubernetes a cloudové konfigurace.

Nebo

O tomto nástroji

Přechod z JSON na YAML je většinou o tom, aby byla data pro lidi čitelnější. Oba formáty popisují stejné druhy struktur – objekty/mapy, pole/sekvence, skaláry – ale syntaxe YAML založená na odsazení, volitelné citace a podpora komentářů usnadňují skenování a úpravy ručně. Konfigurační soubory jsou kanonický případ použití: manifesty Kubernetes, pracovní postupy CI, příručky Ansible a desítky dalších nástrojů si vybraly YAML konkrétně proto, že jejich primárními editory jsou lidé.

Tento převodník používá js-yaml k serializaci analyzovaného objektu JSON do YAML. Výsledek přesně zachovává strukturu dat při použití konvencí YAML: odsazení pro vnoření, seznamy pro pole, páry klíč-hodnota pro vlastnosti objektu. Přísné dvojité uvozování JSON je uvolněné; ve výstupu jsou citovány pouze řetězce obsahující speciální znaky nebo řetězce, které vypadají jako jiné typy.

Konverze zachovává informace kromě případů, kdy YAML přidává expresivitu, kterou JSON neměl. Komentáře nelze rekonstruovat (JSON žádné neměl). Odkazy na kotvy a aliasy by mohly potenciálně komprimovat opakované struktury, ale nejsou generovány automaticky; výstup rozšíří všechny odkazy inline.

Proč převést JSON na YAML

YAML je dramaticky čitelnější než JSON pro úpravy konfigurace lidmi. Odsazení nahrazuje vnoření složených závorek, u jednoduchých řetězců jsou uvozovky volitelné a komentáře mohou dokumentovat nesrozumitelná nastavení. Pro soubory, které lidé udržují – konfigurace aplikací, infrastruktura jako kód, sestavovací kanály – je YAML téměř vždy tím správným cílovým formátem.

Moderní nástroje infrastruktury v drtivé většině upřednostňují YAML. Kubernetes, Helm charts, Ansible, GitHub Actions, GitLab CI, Docker Compose a mnoho dalších nástrojů buď preferují nebo vyžadují YAML. Převod exportů JSON z jednoho systému do konfigurace YAML pro jiný je rutinní integrační krok.

Jak používat

Vložte JSON, získejte YAML.

  1. Přidejte svůj JSON: Vložte text JSON nebo přetáhněte soubor. Vstup musí být platný JSON; převaděč se nepokouší analyzovat vstup podobný JSON, který porušuje specifikaci.
  2. Vyberte možnosti: Výchozí velikost odsazení je 2 mezery, což je nejběžnější konvence YAML. Styl toku (kompaktní JSON) versus styl bloků (založený na odsazení) přepíná vzhled výstupu – blok je výchozí nastavení vhodné pro lidi.
  3. Převést: Funkce dump js-yaml serializuje analyzovaný strom JSON do YAML. Citace řetězců se používají pouze tam, kde je to nutné; složité řetězce zůstávají čitelné.
  4. Stáhnout nebo zkopírovat: Uložit jako .yml nebo zkopírovat do schránky. Výstup je platný YAML 1.2 připravený pro každého spotřebitele YAML.

Běžné případy použití

Technické detaily

Funkce výpisu js-yaml prochází strom objektů JavaScriptu a vysílá YAML pomocí konfigurovatelného formátování. Hloubka odsazení, šířka čáry, práh stylu toku a zpracování nabídek jsou všechny parametry. Výchozí nastavení vytváří YAML ve stylu bloků s odsazením 2 mezer, což je nejběžnější konvence.

Citování řetězců se řídí pravidly YAML: řetězce, které vypadají jako jiné typy (čísla, booleovské hodnoty, null, data), jsou citovány, aby se vynutila interpretace řetězců; řetězce obsahující speciální znaky (dvojtečky, hashe, úvodní pomlčky) jsou v uvozovkách; jednoduché abecední řetězce jsou ponechány bez uvozovek.

Výstup je kompatibilní s YAML 1.2 a analyzuje čistě s js-yaml, PyYAML a dalšími hlavními knihovnami YAML. Idempotentní zpáteční cesty (JSON → YAML → JSON) uchovávají data, ačkoli reprezentace YAML volí kanonické formátování, které se může lišit od ručně psaného ekvivalentu.

Nejlepší postupy

Často kladené dotazy

Změní převod JSON na YAML obsah?
Obsah je zachován co nejpřesněji. Některé funkce specifické pro formát však nemusí mít přímé ekvivalenty, takže mohou nastat drobné rozdíly ve formátování.
Proč používat formát YAML?
YAML je oblíbený pro konfigurační soubory, protože je vysoce čitelný s minimální syntaxí. Je to standard pro Docker Compose, Kubernetes, GitHub Actions a mnoho nástrojů CI/CD.
Zvládá převodník vnořené nebo složité struktury JSON?
Ano. Nástroj správně analyzuje vnořené objekty, pole a všechny standardní datové typy JSON, přičemž ve výstupu YAML zachová úplnou datovou strukturu.
Je tato konverze bezpečná a soukromá?
Ano. Veškeré zpracování probíhá lokálně ve vašem prohlížeči. Vaše data nikdy neopustí vaše zařízení – žádné nahrávání na server, žádné cloudové zpracování, žádný sběr dat.
A co řetězce se speciálními znaky?
js-yaml je cituje automaticky. Řetězce obsahující dvojtečky, hash nebo úvodní pomlčky jsou zabaleny do uvozovek, aby byl YAML dobře tvarovaný.
Jsou moje data nahrána na server?
Ne. Konverze probíhá ve vašem prohlížeči pomocí js-yaml.
Mohu zpáteční cestu JSON do YAML a zpět?
Ano. JSON → YAML → JSON zachovává data strukturálně. Pořadí klíčů převedeného JSON odpovídá vstupu.
Jaká je maximální vstupní velikost?
Až 50 MB. js-yaml zpracuje typické konfigurační soubory okamžitě.