YAML e JSON: quando usar cada um
YAML e JSON descrevem o mesmo tipo de dado — mapas aninhados, listas e valores — mas vivem em mundos diferentes. YAML domina a configuração: manifestos do Kubernetes, Docker Compose, workflows do GitHub Actions e playbooks do Ansible são escritos em YAML porque é fácil de ler e aceita comentários. JSON domina a troca de dados: toda linguagem faz o parse nativamente, toda API REST fala JSON, e a sintaxe estrita não deixa ambiguidades.
É justamente por essa divisão que a conversão aparece todo dia: passar uma configuração YAML para uma ferramenta que só aceita JSON; transformar uma resposta de API em configuração legível; depurar um manifesto do Kubernetes inspecionando-o como JSON com jq. Este conversor funciona nos dois sentidos com validação completa — se o seu YAML tem erro de indentação, você vê o número da linha em vez de uma saída corrompida em silêncio.
Arquivos de configuração carregam senhas de banco, chaves de API e hosts internos o tempo todo. Colar isso num conversor online qualquer é mandar tudo para o servidor de outra pessoa. Esta página converte localmente no navegador: o texto não sai da aba.
Perguntas frequentes
Os comentários são mantidos?
Qual versão de YAML é suportada?
Funciona com YAML multi-documento?
--- viram um array JSON — um elemento por documento.