JSON para YAML em Python

Código Python pronto para copiar nas duas direções, mais as opções que mantêm a saída correta.

Opções de saída

JSONentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

JSON para YAML e de volta com PyYAML

O PyYAML mais o módulo padrão json cobrem as duas direções. Estas opções geram a saída mais limpa.

json_to_yaml.py
import json
import yaml  # pip install pyyaml

with open("data.json", encoding="utf-8") as f:
    data = json.load(f)

with open("data.yaml", "w", encoding="utf-8") as f:
    yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True)
yaml_to_json.py
import json
import yaml  # pip install pyyaml

with open("data.yaml", encoding="utf-8") as f:
    data = yaml.safe_load(f)

with open("data.json", "w", encoding="utf-8") as f:
    # default=str turns dates and datetimes into strings
    json.dump(data, f, indent=2, ensure_ascii=False, default=str)

YAML multidocumento e YAML 1.2

Leia todos os documentos de um arquivo no estilo do Kubernetes com safe_load_all, ou use o ruamel.yaml para as regras do YAML 1.2 e uma indentação precisa.

all_documents.py
import json
import yaml

with open("manifests.yaml", encoding="utf-8") as f:
    docs = list(yaml.safe_load_all(f))  # one item per --- document

print(json.dumps(docs, indent=2, default=str))
ruamel_dump.py
import json
import sys
from ruamel.yaml import YAML  # pip install ruamel.yaml

yaml = YAML()                 # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)

with open("data.json", encoding="utf-8") as f:
    yaml.dump(json.load(f), sys.stdout)

Comandos Python de uma linha

Úteis em scripts de shell e no CI, desde que o PyYAML esteja instalado.

bash
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml

# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json

Problemas comuns e soluções

As surpresas mais frequentes ao converter com o PyYAML. Escolha uma para vê-la antes e depois da correção.

SintomaCausaSolução
As chaves saem ordenadas O safe_dump ordena as chaves por padrão. Passe sort_keys=False.
é vira "\xE9" Caracteres não ASCII recebem escape por padrão. Passe allow_unicode=True.
yes / no / on / off O PyYAML segue o YAML 1.1, então um no sem aspas é carregado como False. Coloque-os entre aspas no YAML ou use o ruamel.yaml (YAML 1.2).
TypeError: datetime is not JSON serializable O safe_load transforma 2026-10-01 em um objeto date. Passe default=str para o json.dump.
load() missing Loader O PyYAML 6 exige um Loader para o yaml.load. Use o yaml.safe_load, que nunca executa código do arquivo.
Só o primeiro documento O safe_load lê um único documento. Use o safe_load_all em arquivos separados por ---.

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como converto JSON para YAML em Python?

Carregue o JSON com json.load e escreva-o com yaml.safe_dump do PyYAML: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). As duas opções mantêm a ordem das chaves e os caracteres não ASCII como estão.

Como converto YAML para JSON em Python?

Leia o arquivo com yaml.safe_load e escreva-o com json.dump(data, f, indent=2, default=str). Use yaml.safe_load_all quando o arquivo tiver vários documentos separados por ---.

Devo usar PyYAML ou ruamel.yaml?

O PyYAML é a escolha mais comum e basta para conversões pontuais. O ruamel.yaml implementa o YAML 1.2, preserva comentários e a ordem das chaves ao editar YAML existente e dá um controle mais fino sobre a indentação.

Por que usar safe_load em vez de load?

O yaml.load com o loader completo pode construir objetos Python arbitrários a partir de tags no arquivo, o que é inseguro para entradas não confiáveis. O safe_load só constrói tipos simples: dicts, listas, strings, números, booleanos, None e datas.

Posso converter sem instalar nada?

Sim. O conversor no topo desta página roda no seu navegador e não precisa de Python, pacotes nem upload. Cole JSON ou YAML e copie o resultado.