YAML to JSON

Co je převod YAML na JSON?

Převod YAML na JSON transformuje data zapsaná ve formátu YAML (YAML Ain't Markup Language) do formátu JSON (JavaScript Object Notation). Oba formáty reprezentují strukturovaná data jako páry klíč-hodnota, sekvence a vnořené objekty, ale liší se syntaxí. YAML používá odsazení a minimální interpunkci, zatímco JSON se opírá o složené závorky, hranaté závorky a povinné uvozovky. Převod mezi těmito formáty je běžný úkol při přesunu konfiguračních dat mezi systémy, které očekávají různé formáty.

YAML byl navržen pro čitelnost člověkem. Podporuje komentáře, víceřádkové řetězce, kotvy a aliasy — žádná z těchto vlastností v JSON neexistuje. Při převodu YAML na JSON jsou tyto vlastnosti specifické pro YAML vyřešeny: kotvy jsou rozvinuty do textu na místě, komentáře jsou zahozeny a víceřádkové bloky se stanou escapovanými řetězci. Výsledkem je platný JSON, který dokáže přečíst libovolný JSON parser.

Specifikace YAML 1.2 explicitně definuje JSON jako podmnožinu YAML, což znamená, že každý platný JSON dokument je zároveň platným YAML dokumentem. Opak neplatí. YAML dokumenty používající komentáře, kotvy nebo složené klíče nemají přímý ekvivalent v JSON a musí být při převodu zjednodušeny. Tento nástroj zpracovává převod automaticky a produkuje čistý, dobře formátovaný JSON z libovolného platného vstupu YAML.

YAML 1.2 Specification — yaml.org →

Proč používat online převodník YAML na JSON?

Ruční převod YAML na JSON je náchylný k chybám, zejména u hluboko vnořených struktur nebo víceřádkových hodnot. Převodník v prohlížeči poskytne výsledek okamžitě a zachytí syntaktické chyby YAML dříve, než se dostanou do vaší aplikace.

Případy použití převodu YAML na JSON

Referenční tabulka mapování typů YAML na JSON

Každý datový typ YAML se při převodu mapuje na konkrétní JSON typ. Tabulka níže zobrazuje každý konstrukt YAML vedle jeho JSON výstupu. Pochopení těchto mapování vám pomůže předvídat, jak budou vaše YAML data vypadat po převodu, a vyhnout se překvapením u typů jako logické hodnoty nebo null.

Syntaxe YAML vs JSON

YAML a JSON reprezentují stejný datový model, ale s různými syntaktickými pravidly. Rozdíly níže vysvětlují, proč některé vlastnosti YAML — jako komentáře a kotvy — nemají ekvivalent v JSON.

Příklady kódu

Níže jsou funkční příklady pro programový převod YAML na JSON. Každý příklad parsuje řetězec YAML a vypisuje formátovaný JSON.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

Časté dotazy