Neste artigo
JSON vs YAML: compreendendo os formatos
JSON (JavaScript Object Notation) e YAML (YAML Ain't Markup Language) são os dois formatos de serialização de dados mais populares no desenvolvimento de software moderno. JSON é o padrão para APIs web e troca de dados em navegadores, enquanto YAML domina os ficheiros de configuração de ferramentas como Kubernetes, Docker Compose, GitHub Actions e Ansible.
Embora ambos os formatos representem as mesmas estruturas de dados (objetos, arrays, strings, números), YAML substitui as chaves e colchetes do JSON por uma estrutura baseada em indentação, tornando-o mais legível para configurações complexas.
Como funciona a conversão de JSON para YAML
A conversão entre JSON e YAML é um processo simples porque ambos os formatos suportam os mesmos tipos de dados.
- JSON para YAML — o conversor analisa o JSON e serializa o resultado usando sintaxe YAML com indentação em vez de chaves
- YAML para JSON — o conversor analisa o YAML (respeitando a indentação e funcionalidades especiais do YAML como âncoras) e produz JSON compacto
- Ambas as direções preservam os tipos de dados — strings, números, booleanos, valores nulos, arrays e objetos aninhados são todos convertidos sem perda
Experimente gratuitamente — sem cadastro
Converter JSON / YAML →Quando usar o conversor
O conversor JSON para YAML é útil para programadores que trabalham com ferramentas que exigem formatos diferentes.
- Configuração Kubernetes — converter respostas de API JSON em manifestos YAML para kubectl apply
- Pipelines CI/CD — transformar dados JSON em YAML para configurações do GitHub Actions, GitLab CI ou CircleCI
- Testes de API — converter fixtures de teste YAML em corpos de requisição JSON para Postman ou curl
Perguntas frequentes
O YAML pode representar tudo o que o JSON pode?
Sim. YAML é um superconjunto de JSON — todo documento JSON válido também é YAML válido. YAML suporta adicionalmente comentários, âncoras/aliases, strings multilínea e uma sintaxe mais expressiva. A conversão de JSON para YAML nunca perde dados.
E quanto às funcionalidades YAML que o JSON não suporta?
Algumas funcionalidades YAML como âncoras, aliases e tags personalizadas não têm equivalente em JSON. Ao converter tal YAML para JSON, as âncoras são resolvidas (expandidas inline) e as tags personalizadas são geralmente removidas. O JSON resultante ainda contém todos os dados, apenas sem os metadados específicos do YAML.
A conversão é sem perda?
Para os tipos de dados padrão (strings, números, booleanos, null, arrays, objetos), a conversão é completamente sem perda em ambas as direções. A única diferença é a formatação — JSON usa chaves e colchetes, YAML usa indentação.