JSON para YAML

O que é a Conversão de JSON para YAML?

A conversão de JSON para YAML transforma dados do JavaScript Object Notation para o YAML Ain't Markup Language. Ambos os formatos representam as mesmas estruturas de dados (objetos, arrays, strings, números, booleanos, null), mas usam sintaxes diferentes. JSON usa chaves, colchetes e vírgulas. YAML usa indentação e quebras de linha, produzindo uma saída mais próxima do texto simples. Ao contrário do XML, nenhum dos formatos exige um esquema.

YAML foi projetado como um formato de serialização de dados amigável para humanos. É a linguagem de configuração padrão para manifestos do Kubernetes, arquivos Docker Compose, playbooks do Ansible, workflows do GitHub Actions e muitos sistemas de CI/CD. Quando seus dados de origem estão em JSON e o sistema de destino espera YAML, você precisa de um conversor que preserve cada valor, tipo e nível de aninhamento com exatidão, sem perda de dados.

Converter JSON para YAML online é útil quando você recebe respostas de API ou dados exportados em JSON e precisa colá-los em um arquivo de configuração YAML. A conversão é sem perda para todos os tipos JSON padrão: strings, números, booleanos, null, arrays e objetos são mapeados diretamente para seus equivalentes YAML. Valores que contêm dois-pontos ou caracteres especiais são automaticamente colocados entre aspas para que a saída seja YAML válido.

Por que Converter JSON para YAML?

YAML é o padrão para arquivos de configuração; JSON é o que as APIs retornam. Converter entre eles permite usar o formato certo para cada tarefa sem reescrever dados manualmente.

Casos de Uso: JSON para YAML

Comparação: JSON vs YAML

JSON e YAML podem representar os mesmos dados, mas sua sintaxe e capacidades diferem de formas que importam para casos de uso específicos.

Armadilhas do YAML Após a Conversão

YAML tem regras de análise que surpreendem desenvolvedores vindos do JSON. Esses quatro problemas causam a maioria dos bugs ao trabalhar com a saída convertida.

Exemplos de Código

Converter JSON para YAML programaticamente requer uma biblioteca de serialização YAML na maioria das linguagens. A biblioteca padrão cuida da análise do JSON; a saída YAML precisa de um pacote adicional.

import YAML from 'js-yaml'

const json = '{"host":"localhost","port":3000,"debug":true}'
const obj = JSON.parse(json)
const yamlStr = YAML.dump(obj, { indent: 2 })
console.log(yamlStr)
// → host: localhost
// → port: 3000
// → debug: true

import json, yaml

json_str = '{"host": "localhost", "port": 3000, "debug": true}'
data = json.loads(json_str)
yaml_str = yaml.dump(data, default_flow_style=False, sort_keys=False)
print(yaml_str)
# → host: localhost
# → port: 3000
# → debug: true

package main

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

func main() {
    jsonStr := `{"host":"localhost","port":3000,"debug":true}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    yamlBytes, _ := yaml.Marshal(data)
    fmt.Println(string(yamlBytes))
    // → debug: true
    // → host: localhost
    // → port: 3000
}

# Using yq (https://github.com/mikefarah/yq)
echo '{"host":"localhost","port":3000}' | yq -P
# → host: localhost
# → port: 3000

# Using Python one-liner
echo '{"host":"localhost","port":3000}' | python3 -c "import sys,json,yaml; print(yaml.dump(json.load(sys.stdin), default_flow_style=False))"

Perguntas Frequentes