Como usar
- Cole seu JSON em Texto JSON.
- Escolha o Recuo desejado. Dois espaços é a escolha usual para arquivos YAML.
- Leia Validade. Se ela indicar uma linha e uma coluna, corrija o JSON ali antes.
- Copie o Texto YAML, ou baixe-o como data.yaml.
Como o JSON vira YAML
A especificação YAML 1.2 busca tornar o YAML um superconjunto estrito do JSON, então um texto JSON é dado YAML válido. A conversão mantém os mesmos dados e muda só a forma de escrevê-los. Um objeto vira linhas do tipo nome: valor, um array vira uma lista com um traço antes de cada item, e o aninhamento aparece pelo recuo em vez de colchetes.
- Textos, números, true, false e null mantêm os seus valores. Um texto que o YAML leria como outro tipo, como “true” ou “123”, é escrito entre aspas para continuar sendo texto.
- Uma data como 2026-11-10 continua texto simples, porque o YAML 1.2 não a lê como data. yes e on também continuam texto, já que o YAML 1.2 lê só true e false como booleanos.
Números, nomes e linhas de texto
Números inteiros mantêm todos os dígitos: 12345678901234567890 é escrito exatamente como foi digitado. Um número decimal é escrito como o número JavaScript mais próximo, então 1.50 vira 1.5 com o mesmo valor. Um decimal com mais de cerca de 15 dígitos significativos pode mudar nos últimos dígitos.
Os nomes mantêm a ordem que têm no JSON, inclusive nomes como 2024 que um objeto JavaScript levaria para o início. Um texto com quebras de linha é escrito como bloco, então cada uma das suas linhas continua em uma linha própria.
Exemplo resolvido: o JSON padrão
O JSON padrão é um objeto com cinco nomes: name, free, tags, version e license. A lista em tags vira uma lista YAML, com um traço e dois espaços antes de cada item.
Com dois espaços de recuo, o resultado são as oito linhas da tabela, e ele volta a dar os mesmos dados.
| Linha | YAML escrito |
|---|---|
| 1 | name: FireToolLand |
| 2 | free: true |
| 3 | tags: |
| 4 | - json |
| 5 | - csv |
| 6 | - yaml |
| 7 | version: 2.1 |
| 8 | license: null |
Perguntas frequentes
YAML é a mesma coisa que JSON?
Não exatamente, mas a especificação YAML 1.2 busca tornar o YAML um superconjunto estrito do JSON, então os dados sobrevivem à conversão. O YAML usa recuo em vez de colchetes, o que facilita a leitura à mão.
Por que alguns textos aparecem entre aspas no YAML?
Um texto que o YAML leria como outro tipo, como “true”, “123” ou “null”, é escrito entre aspas para continuar sendo texto. Os outros textos são escritos sem aspas.
Os números são alterados?
Números inteiros mantêm todos os dígitos, então 12345678901234567890 continua o mesmo. Um decimal é escrito como o número mais próximo, então 1.50 vira 1.5 com o mesmo valor.
Por que dois ou quatro espaços de recuo?
O YAML mostra o aninhamento com espaços, não com tabulações. Dois espaços geram um arquivo mais curto e quatro um arquivo mais largo; os dois dão os mesmos dados na volta, então escolha o estilo que o seu projeto usa.
Por que um nome que aparece duas vezes em um objeto é recusado?
Um mapeamento YAML guarda um valor para cada nome, então o segundo valor se perderia sem nenhum aviso. A ferramenta pede que você remova o nome repetido em vez de adivinhar qual valor manter.
Meu JSON é enviado para algum lugar?
Não. A conversão roda no seu navegador com a biblioteca yaml, e nada do que você cola é enviado para o nosso servidor.
Fontes
- YAML Ain't Markup Language (YAML) (em inglês), revisão 1.2.2
- RFC 8259 (em inglês): The JavaScript Object Notation (JSON) Data Interchange Format
- yaml (em inglês): the JavaScript YAML library used by this tool
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.