Konvertor JSON do YAML
Prepíšte JSON do YAML, ktorý sa dá ľahko čítať, kontrolovať a komentovať. Nahrajte súbory .json a získate odsadené súbory .yaml s rovnakými kľúčmi, hodnotami aj poradím, pripravené na vloženie do repozitára.
Prevodník dát
alebo sem presuňte súbory CSV, TSV, TXT … ·
Max. 95 MB na súbor· Až 20 súborov· Odstránenie po 30 minútach
Súbory sa spracúvajú na našich serveroch a po 30 minútach sa odstránia.
Znak, ktorý oddeľuje stĺpce v súboroch CSV a textových súboroch, pri čítaní aj zápise. Automaticky ho rozpozná zo vstupu a zapisuje čiarky.
UTF-8 funguje pre všetky jazyky. Vyberte UTF-8 s BOM, ak Excel vo Windowse po otvorení CSV zobrazuje pokazenú diakritiku alebo ázijské znaky.
Vstup z Excelu, ODS a Numbers: previesť len prvý hárok alebo všetky hárky (jeden CSV na hárok v ZIP alebo jeden kľúč JSON na hárok).
Názov karty hárka v novej tabuľke, najviac 31 znakov.
Pole objektov používa názvy stĺpcov ako kľúče pre každý riadok; pole polí je kompaktnejšie a hlavičku ponechá ako prvé pole.
Názov vonkajšieho prvku, ktorý obaľuje všetky riadky; každý riadok sa v ňom stane prvkom <row>.
Používa sa v príkazoch CREATE TABLE a INSERT. Iba písmená, číslice a podčiarkovníky.
Úvodzovky a typy stĺpcov sa medzi databázami mierne líšia; vyberte tú, do ktorej budete importovať.
Prepíše bunky s dátumom do jedného formátu. ISO (2026-10-18) je najbezpečnejší pre databázy a kód; ponechať ich nechá tak, ako sú v zdroji.
Ako používať tento nástroj
- 1
Pridajte súbory JSON
Nahrajte odpovede API, exportované nastavenia alebo vygenerované manifesty ako .json, najviac 20 súborov po 95 MB. Každý súbor musí obsahovať jednu platnú hodnotu JSON.
- 2
Ponechajte predvolené nastavenia
YAML je už vybraný v poli Previesť na. Pre konfiguračný súbor netreba nič meniť; výstup používa odsadenie dvoma medzerami.
- 3
Preveďte a uložte do repozitára
Stlačte Previesť na YAML, stiahnite súbory .yaml, pridajte komentáre tam, kde ich bude potrebovať ďalší čitateľ, a odošlite zmeny do repozitára.
Ako previesť JSON na YAML?
Nahrajte súbor .json a stlačte Previesť na YAML. Objekty sa zmenia na odsadené bloky kľúč: hodnota, polia na zoznamy s pomlčkami a reťazce, ktoré by YAML mohol zle pochopiť, si zachovajú úvodzovky.
Prečo previesť JSON do YAML pri konfiguračných súboroch
Väčšinu JSON vytvára softvér: odpoveď API, export nastavení, výstup generátora. Väčšinu YAML udržiavajú ľudia. Prevod často označuje chvíľu, keď dáta prestanú byť strojovým výstupom a stanú sa niečím, čo tím vlastní, napríklad manifest nasadenia v Gite, pipeline CI alebo sada premenných Ansible.
Typický prípad: zavoláte cloudové API, dostanete 200-riadkový opis zdroja v JSON a chcete ho uchovať ako infraštruktúru v kóde. Prevod vám dá súbor bez zátvoriek a čiarok, kde zmena jedného riadka vytvorí rozdiel v jednom riadku a nezvyčajné hodnoty vysvetlíte v komentároch. To isté platí pre testovacie dáta a prekladové súbory, ktoré upravujú aj nevývojári. Ak namiesto toho potrebujete plochú tabuľku, napríklad pre tabuľkový procesor alebo report, lepšie sedí JSON do CSV.
Nástroje, ktorých konfiguračné súbory sú v YAML
| Organizácia | Požiadavka | Zdroj |
|---|---|---|
| GitHub Actions | Workflowy sú v .github/workflows ako súbory .yml alebo .yaml | GitHub Docs |
| GitLab CI/CD | Pipeline je definovaná v .gitlab-ci.yml v koreni repozitára | GitLab Docs |
| Docker Compose | Služby sa opisujú v compose.yaml (predtým docker-compose.yml) | Docker Docs |
| Ansible | Playbooky a súbory s premennými sa píšu v YAML | Ansible Docs |
| Kubernetes | Manifesty prijímajú JSON alebo YAML; dokumentácia a charty Helm používajú YAML | Kubernetes |
Príklad prevodu JSON do YAML so záludnými hodnotami
name: eshop-api version: "1.10" debug: false tags: - web - eu country: "NO"
Čo vám dáva YAML
- Komentáre pomocou #
- Kratšie rozdiely pri code review
- Bez zátvoriek, čiarok a úvodzoviek na väčšine riadkov
- Viacriadkový text pomocou blokových skalárov |
Na čo si dať pozor
- Odsadenie má význam, preto zatúlaná medzera zmení štruktúru
- Tabulátory na odsadenie nie sú povolené
- Reťazce bez úvodzoviek sa môžu čítať ako čísla alebo logické hodnoty
- Pomalšie a menej jednotné parsery ako pri JSON
Príklad ukazuje, prečo nestačí obyčajné nahradenie zátvoriek. Verzia 1.10 je v JSON reťazec; zapísaná v YAML bez úvodzoviek by sa čítala ako číslo 1.1. NO, kód ISO pre Nórsko, by parsery YAML 1.1, napríklad PyYAML, čítali ako false. Obe hodnoty si zachovajú úvodzovky, kým skutočné čísla a logické hodnoty zostanú bez nich.
Porovnanie JSON a YAML
JSON
JavaScript Object Notation
JSON je ľahký textový formát pre štruktúrované dáta, ktorý na začiatku 21. storočia spopularizoval Douglas Crockford a ktorý je normalizovaný ako RFC 8259 a ECMA-404. Pomocou jednoduchej, čitateľnej syntaxe vyjadruje objekty, polia, reťazce, čísla, booleovské hodnoty a null. Je predvoleným formátom webových API, konfiguračných súborov a výmeny dát medzi aplikáciami takmer v každom programovacom jazyku. Nemá vstavané komentáre, dátumy ani schémy a veľké vnorené súbory sa bez prehliadača ťažko čítajú.
- Kompresia
- –
- Priehľadnosť
- –
- Animácia
- –
- Rok vzniku
- 2001 · Douglas Crockford
YAML
YAML
YAML („YAML Ain't Markup Language“) je dátový formát vhodný pre ľudí, prvýkrát vydaný v roku 2001. Namiesto zátvoriek používa odsadenie, podporuje komentáre a je nadmnožinou JSON. Široko sa využíva na konfiguráciu v Docker Compose, Kubernetes, GitHub Actions a mnohých aplikáciách. Keďže závisí od medzier, dá sa ľahko pokaziť jedinou zle umiestnenou medzerou a niektoré hodnoty, napríklad „no“ alebo dátumy, sa môžu vyhodnotiť neočakávane.
- Kompresia
- –
- Priehľadnosť
- –
- Animácia
- –
- Rok vzniku
- 2001 · Clark Evans, Ingy döt Net, Oren Ben-Kiki
JSON sa prevádza na YAML, keď sa vygenerované dáta alebo dáta z API majú stať konfiguračným súborom, ktorý ľudia udržiavajú, kontrolujú v pull requestoch a dopĺňajú komentármi.
Otázky o konvertore JSON do YAML
Je JSON už platný YAML?
V YAML 1.2 áno: revízia z roku 2009 vznikla tak, aby bol každý dokument JSON zároveň dokumentom YAML. JSON by ste mohli vložiť do súboru .yaml a väčšina nástrojov by ho prijala. Prevod ide o čitateľnosť: blokový štýl bez zátvoriek, úvodzoviek a čiarok je to, čo očakávajú recenzenti aj ďalší správca.
Prečo sú niektoré hodnoty v YAML v úvodzovkách?
Bez úvodzoviek by ich YAML prečítal ako iný typ. Verzia ako 1.10 by sa stala číslom 1.1 a yes alebo off by sa v starších parseroch mohli stať logickými hodnotami. Reťazce, ktoré vyzerajú ako čísla, dátumy či logické hodnoty, potrebujú úvodzovky, aby zostali reťazcami, preto ich dôkladný prevod zachová.
Môžem po prevode pridať komentáre?
Áno, a je to častý dôvod prevodu. Napíšte # a za to poznámku na koniec riadka alebo na samostatný riadok. JSON nemal ako vysvetliť, prečo je hodnota nastavená; YAML to dokáže, čo uľahčuje recenzie aj odovzdávanie práce.
Prečo môj YAML hlási chybu so znakom tabulátora?
Špecifikácia YAML zakazuje tabulátory na odsadenie; platia len medzery. Konvertor píše medzery, ale editor nastavený na vkladanie tabulátorov môže súbor pri ďalšej úprave pokaziť. Nastavte si editor, aby v súboroch .yaml používal medzery.
Prijme Kubernetes prevedený manifest?
kubectl číta JSON aj YAML, takže dáta sú rovnaké; verzia YAML je len to, čo používa väčšina dokumentácie, chartov Helm a code review. Ak neskôr potrebujete JSON späť pre jq alebo volanie API, YAML na JSON to vráti.
- Prevod YAML do JSONPreveďte súbory .yaml a .yml do JSON pre API, validátory a nástroje, ktoré čítajú len JSON. Odsadený výstup, dávky po 20, mazanie po 30 min.
- Prevod JSON do XMLPrevieďte JSON do XML online: kľúče sa stanú elementmi, polia opakovanými elementmi v koreňovom tagu podľa vás. Prehľadný výstup, bez účtu.
- Previesť JSON do CSVPrevod JSON alebo JSON Lines do CSV: riadok na objekt, vnorené polia ako stĺpce, UTF-8 s BOM pre správnu diakritiku v Exceli. Naraz 20 súborov.
- Konvertor XML do JSONPrevieďte XML na čitateľný JSON: atribúty ako kľúče @, opakované značky ako polia, text bez zmien. Pre odpovede SOAP, feedy a staré exporty.
- Kódovanie JSON do Base64Zakódujte JSON súbor do jedného riadka Base64 pre Kubernetes Secrets, premenné CI, API a tokeny. Úplne vratné, voliteľne ako data URI.
- Konvertor JSON do ExceluPreveďte JSON alebo JSON Lines do hárka Excel XLSX: kľúče sa stanú hlavičkami stĺpcov, každý záznam riadkom. Až 20 súborov naraz, bez registrácie.