Converter entre JSON e YAML

Esta ferramenta transforma um documento YAML em JSON e vice-versa, preservando a estrutura dos dados (objetos, arrays, tipos escalares). A conversão JSON para YAML, ou YAML para JSON, é uma operação comum no desenvolvimento: gera-se um ficheiro OpenAPI YAML a partir de uma spec JSON, converte-se a saída de uma API REST em YAML para a colocar num repositório de configuração, traduz-se um manifesto Kubernetes YAML em JSON para o passar a kubectl --dry-run=client -o json, ou alinha-se um workflow GitHub Actions com um esquema JSON. De forma mais ampla, é a ponte entre o mundo do intercâmbio de dados (JSON) e o da configuração editável à mão (YAML).

JSON e YAML respondem a necessidades próximas mas casos de uso diferentes. A tabela seguinte resume as diferenças técnicas principais, úteis para escolher entre os dois conforme o contexto.

O JSON impõe-se assim que um programa fala com outro programa. Os seus casos de uso típicos:

• APIs REST e GraphQL: payloads de pedido e de resposta.
• Intercâmbio de dados entre microsserviços e filas de mensagens.
• Código JavaScript nativo: JSON.parse e JSON.stringify sem dependência.
• Armazenamento no lado do navegador: localStorage, sessionStorage, IndexedDB.
• Pedidos AJAX e fetch.
• Variantes binárias ou orientadas a fluxo: BSON (MongoDB), JSON Lines (logs, datasets ML), MessagePack.
• Configuração de ferramentas JS / TS: package.json, tsconfig.json, composer.json.

O YAML impõe-se assim que um humano edita regularmente o ficheiro. Os seus casos de uso típicos:

• Docker Compose (docker-compose.yml) e perfis de stack.
• Manifestos Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbooks Ansible e inventários.
• Pipelines CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Especificações OpenAPI / Swagger e AsyncAPI.
• Configuração aplicacional anotada (Symfony, Spring Boot, Rails) onde os comentários são úteis.
• Ficheiros editados frequentemente à mão, em que a concisão e a legibilidade prevalecem sobre a velocidade de parsing.

O YAML é mais permissivo do que o JSON, o que o torna um formato poderoso mas traiçoeiro. As armadilhas mais frequentes:

• Indentação: as tabulações são proibidas pela especificação, apenas os espaços são válidos. Misturar os dois ou mudar o número de espaços num mesmo bloco quebra o parsing.
• Coerção automática dos escalares: yes, no, on, off, true, false, null, None, ~ são interpretados como booleanos ou null. Exemplo armadilha: um código postal 01234 não citado torna-se o inteiro 1234, e um nome de país NO (Noruega) torna-se false. Cite sempre as strings ambíguas.
• Strings multilinhas: | (block literal) conserva as quebras de linha tal como estão, enquanto > (folded) substitui as quebras de linha por espaços. Os indicadores de chomping - e + ajustam o comportamento na quebra final.
• YAML 1.1 vs 1.2: a 1.1 (ainda muito difundida, por exemplo via PyYAML por defeito) trata yes/no/on/off como booleanos, o que a 1.2 eliminou. Os comportamentos também diferem nos números em base 8.
• Datas implícitas: 2024-01-15 sem aspas é interpretado como um objeto data por alguns parsers, não como uma string.

O mesmo documento, expresso em JSON e depois em YAML. Configuração simples de uma aplicação com as suas dependências e o seu ambiente:

Versão JSON

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Versão YAML equivalente

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

A versão YAML é mais curta em cerca de 25 % em caracteres, aceita um comentário no início e lê-se como uma lista de propriedades sem ruído sintático.

Passos para converter os seus dados:

1. Cole o seu documento fonte (JSON ou YAML) no campo de entrada.
2. Selecione o sentido de conversão pretendido (JSON para YAML, ou YAML para JSON).
3. Clique no botão de conversão: o resultado formatado aparece na área de saída.
4. Verifique a rendição, depois use o botão de cópia para recuperar o resultado para a sua área de transferência.

A conversão é efetuada localmente no seu navegador ou através de uma rota de servidor dedicada conforme o tooling: nenhum dado sensível é conservado.