JSON ↔ YAML Converter
Understand JSON ↔ YAML Converter
Este conversor move os mesmos dados entre JSON e YAML, os dois formatos em que a maior parte dos arquivos de configuração é escrita.
How it works
Os dois formatos descrevem as mesmas três coisas — mapeamentos, sequências e escalares — então converter é reimprimir, não traduzir. Indo para YAML, a estrutura vira indentação em vez de chaves, e qualquer string que seria relida como número, booleano ou null recebe aspas para continuar sendo string. Indo para JSON, a indentação volta a ser chaves e colchetes, e os comentários são descartados porque o JSON não tem onde colocá-los.
When to use it
- Transformar uma resposta de API em uma fixture YAML para um teste ou um arquivo de configuração.
- Converter um trecho de Docker Compose ou Kubernetes para JSON, de modo que um script possa lê-lo com um parser JSON comum.
- Reescrever YAML feito à mão como JSON para achar o ponto exato em que um parser discorda de você.
- Mover configurações entre duas ferramentas que leem formatos diferentes.
Watch out for
- Comentários não sobrevivem à ida e volta. Em um arquivo de configuração real, os comentários carregam a maior parte da documentação, e o JSON não tem como representá-los.
- Em parsers YAML 1.1 — o PyYAML por padrão e boa parte das ferramentas mais antigas — os valores sem aspas yes, no, on e off são booleanos, então um código de país NO vira false. Este conversor segue o YAML 1.2 e os mantém como strings, o que significa que um valor pode parecer correto aqui e virar outra coisa mais adiante no seu pipeline. Use aspas de todo modo.
- O conversor lida com o formato que a maioria dos arquivos de configuração tem: chaves de primeiro nível, mapeamentos aninhados e listas simples. Âncoras e aliases (&base, *base), escalares de bloco (| e >) e arquivos com vários documentos separados por --- não são transferidos.
Not the right tool for: Fazer a ida e volta de um Helm chart ou de qualquer YAML com templates. Converter para JSON e voltar descarta as âncoras e a sintaxe de template que fazem dele um template.
Frequently Asked Questions
Como converter YAML para JSON?
Cole seu YAML na entrada, selecione "YAML → JSON" e clique em Converter. A ferramenta interpreta YAML (incluindo âncoras e strings de várias linhas) e devolve JSON formatado. Usa-se YAML 1.2, então "yes"/"no"/"on"/"off" são strings, e não booleanos — o que corresponde à semântica do JSON.
Como converter JSON para YAML?
Cole seu JSON, selecione "JSON → YAML" e clique em Converter. Todos os tipos do JSON têm equivalente em YAML: strings, números, booleanos, null, objetos (mapeamentos YAML) e arrays (sequências YAML). Comentários não são transferidos, já que o JSON não tem nenhum.
Quais são as armadilhas comuns do parsing de YAML ao converter a partir de JSON?
Códigos de país como "NO" e "ON" são lidos como booleanos no YAML 1.1. Strings de versão como "1.2" viram floats. Números com cara de octal, como "0755", são lidos em octal. Coloque esses valores entre aspas para preservar o tipo string.
How to Use JSON ↔ YAML Converter
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.