Como converter JSON para YAML

Quando usar esta conversão

A conversão transforma texto JSON em texto YAML com apresentação em bloco, o que pode facilitar a leitura de estruturas com vários níveis. Pode trabalhar com objetos, objetos aninhados e listas, incluindo dados com caracteres Unicode. O resultado não é uma simples cópia visual do texto de origem: o recuo organiza a hierarquia, as listas não vazias recebem marcadores e algumas cadeias de caracteres podem ser colocadas entre aspas quando o seu conteúdo tem significado especial em YAML.

Esta abordagem é adequada quando já dispõe de JSON e precisa de o consultar ou reutilizar em YAML. Antes de começar, confirme que a entrada representa JSON válido, exceto se pretende verificar o comportamento de uma entrada vazia. Não é necessário escrever manualmente a estrutura convertida, porque a ferramenta trata da passagem entre os dois formatos de texto.

Passos para converter o conteúdo

1. Prepare o conteúdo em formato JSON e reveja a sintaxe. Pode fornecer um objeto simples, incluir objetos dentro de outros objetos ou usar uma lista, desde que o texto seja JSON válido.
2. Cole ou escreva esse conteúdo no campo de entrada. O preenchimento não é obrigatório: uma caixa vazia ou formada apenas por espaços em branco é aceite e conduz a uma conversão bem-sucedida com texto YAML vazio.
3. Escolha a indentação se precisar de controlar a distância usada para representar cada nível. A opção é numérica e, quando não define outro valor, é aplicada a predefinição de 2 espaços.
4. Ative a ordenação das chaves dos mapas apenas se quiser pedir essa preferência. A opção está desativada por predefinição; quando a ativa, a ordem apresentada pode ser diferente da ordem visível no texto JSON de entrada.
5. Inicie a conversão e examine o texto produzido. Procure os níveis de recuo dos objetos e os marcadores das listas para confirmar que a estrutura tem a forma esperada.
6. Se a operação não for bem-sucedida, volte à entrada e valide o JSON antes de repetir a ação. Uma falha ocorrida durante a produção do YAML também resulta numa conversão sem sucesso, não num resultado apresentado como concluído.

Como interpretar o resultado

Num resultado bem-sucedido, o YAML aparece em estilo de blocos, com os níveis relacionados visualmente através do recuo. Um objeto aninhado fica associado ao respetivo nível, enquanto cada elemento de uma lista não vazia é identificado por um marcador. Os caracteres Unicode são preservados, mas uma cadeia que possa ser interpretada como sintaxe YAML pode surgir entre aspas para manter o seu significado textual.

A alteração da indentação afeta a forma como a hierarquia é apresentada, e a preferência de ordenação pode modificar a sequência das chaves dos mapas. Por isso, compare a estrutura e não apenas o aspeto de uma linha isolada. Quando a entrada está vazia ou contém só espaços, o texto YAML vazio representa o resultado previsto de uma operação bem-sucedida.

Há uma fronteira importante: a ferramenta recebe texto JSON e não deve ser usada como substituto de uma validação de esquema. Também não há confirmação de que todos os pormenores de formatação do original sejam preservados ou de que uma conversão de ida e volta produza exatamente o texto JSON inicial.

Exemplo prático

Uma pessoa recebe o JSON {"projeto":"Atlas","etapas":["análise","revisão"]} e pretende obter uma representação YAML organizada em bloco.

Introduza o texto JSON, mantenha a indentação predefinida de 2 espaços e inicie a conversão sem ativar a ordenação das chaves.

O resultado bem-sucedido tem texto YAML em estilo de blocos, com objetos aninhados recuados e elementos da lista não vazia precedidos por marcadores.

Limitações

• O resultado depende da conversão de texto JSON e uma falha durante a serialização pode terminar a operação sem sucesso; não é confirmada validação de esquemas nem preservação integral da formatação original.

Erros comuns

• Uma vírgula extra ou uma chave sem aspas torna o JSON inválido e impede a produção de YAML. Corrija a sintaxe da entrada e repita a conversão.

Perguntas frequentes

Tenho de introduzir JSON para iniciar a conversão?

A entrada pode ficar vazia ou conter apenas espaços em branco, porque o preenchimento é opcional; nesse caso, a operação é bem-sucedida e o resultado não contém texto YAML.

A ferramenta aceita listas JSON?

Uma lista é aceite quando integra um JSON válido. No resultado, os elementos de uma lista não vazia são dispostos com marcadores, tal como acontece na representação em bloco.

Que resultado tenho com JSON inválido?

A operação termina sem sucesso e não fornece texto YAML quando a entrada não é JSON válido. Reveja a sintaxe e tente novamente depois de corrigir o conteúdo.