YAML to JSON

Что такое конвертация YAML в JSON?

Конвертация YAML в JSON преобразует данные, записанные в формате YAML (YAML Ain't Markup Language), в формат JSON (JavaScript Object Notation). Оба формата представляют структурированные данные в виде пар ключ-значение, последовательностей и вложенных объектов, но различаются синтаксисом. YAML использует отступы и минимальную пунктуацию, тогда как JSON требует фигурных скобок, квадратных скобок и обязательного заключения строк в кавычки. Конвертация между этими форматами — распространённая задача при переносе конфигурационных данных между системами, ожидающими разные форматы.

YAML разработан для удобочитаемости. Он поддерживает комментарии, многострочные строки, якоря и псевдонимы — ни одна из этих возможностей не существует в JSON. При конвертации YAML в JSON эти специфические возможности YAML разрешаются: якоря раскрываются на месте, комментарии отбрасываются, а многострочные блоки превращаются в экранированные строки. На выходе получается валидный JSON, который может прочитать любой JSON-парсер.

Спецификация YAML 1.2 явно определяет JSON как подмножество YAML — это означает, что каждый валидный JSON-документ является одновременно валидным YAML. Обратное неверно. Документы YAML, использующие комментарии, якоря или сложные ключи, не имеют прямого эквивалента в JSON и должны быть упрощены при конвертации. Этот инструмент выполняет конвертацию автоматически, создавая чистый, корректно отформатированный JSON из любого валидного YAML-ввода.

YAML 1.2 Specification — yaml.org →

Зачем использовать онлайн-конвертер YAML в JSON?

Конвертация YAML в JSON вручную чревата ошибками, особенно при глубоко вложенных структурах или многострочных значениях. Браузерный конвертер выдаёт результат мгновенно и обнаруживает синтаксические ошибки YAML ещё до того, как они попадут в приложение.

Сценарии использования YAML в JSON

Справочник соответствия типов YAML и JSON

Каждый тип данных YAML при конвертации соответствует определённому типу JSON. В таблице ниже показаны конструкции YAML и соответствующий им JSON-вывод. Понимание этих соответствий поможет предсказать, как данные YAML будут выглядеть после конвертации, и избежать неожиданностей с такими типами, как булевы значения или null.

Синтаксис YAML и JSON

YAML и JSON представляют одну и ту же модель данных, но с разными правилами синтаксиса. Различия ниже объясняют, почему некоторые возможности YAML — например, комментарии и якоря — не имеют эквивалента в JSON.

Примеры кода

Ниже приведены рабочие примеры программной конвертации YAML в JSON. Каждый пример разбирает строку YAML и выводит отформатированный 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

Часто задаваемые вопросы