Diferença entre JSON e YAML
JSON e YAML descrevem os mesmos tipos de dados (objetos, listas, textos e números), mas com sintaxes diferentes. O JSON usa chaves, colchetes e aspas, é compacto e é o formato padrão das APIs web. O YAML usa indentação por espaços em vez de chaves, dispensa a maioria das aspas e aceita comentários, o que o torna mais legível para humanos e muito popular em arquivos de configuração. Na prática, todo JSON válido também é YAML válido, já que o YAML é um superconjunto. Converter entre os dois ajuda a mover dados entre APIs e ferramentas de configuração.
Quando usar YAML
Use YAML principalmente em arquivos de configuração, onde a leitura por humanos importa. Ele é o formato de pipelines de CI/CD como GitHub Actions e GitLab CI, de orquestração com Docker Compose e Kubernetes, e de muitas ferramentas de infraestrutura. A indentação limpa e os comentários deixam esses arquivos fáceis de entender e revisar. Para troca de dados entre sistemas e APIs, o JSON costuma ser melhor, por ser mais rígido e ter suporte nativo em praticamente toda linguagem. Um cuidado do YAML: como ele depende de espaços, um recuo errado muda o significado, então tabulações são proibidas.
Comentários se perdem na conversão?
Sim, os comentários do YAML se perdem ao converter para JSON, porque o JSON não tem sintaxe de comentário. Quando você transforma um YAML em JSON e depois de volta, as linhas de comentário desaparecem, já que não existe onde guardá-las no formato intermediário. Fora isso, a estrutura de listas e objetos aninhados é preservada nos dois sentidos, com indentação de dois espaços no YAML gerado. Por isso, se você mantém a configuração original em YAML com comentários importantes, use a conversão só para inspecionar ou gerar, e não como substituto do arquivo comentado.
Como usar esta ferramenta
- Escolha o sentido: JSON para YAML ou YAML para JSON.
- Cole o conteúdo no campo de entrada.
- Copie o resultado convertido com um clique.
Perguntas Frequentes (FAQ)
- O YAML gerado mantém a indentação correta?
- Sim. A ferramenta usa uma indentação de dois espaços e representa listas e objetos aninhados no formato padrão do YAML, pronto para colar em um arquivo de configuração.
- Posso converter um docker-compose ou GitHub Actions?
- Sim. Cole o YAML e converta para JSON para inspecionar a estrutura, ou faça o caminho inverso. Só lembre que comentários do YAML não têm equivalente em JSON e são perdidos.
- Meus dados são enviados para algum servidor?
- Não. Toda a conversão acontece no seu navegador, então é seguro converter arquivos de configuração com segredos ou dados sensíveis.
