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.
JSONentrada
YAMLsaída
Cada linha da saída, com a formatação padrão, ao lado do caminho do valor que ela contém. Clique em uma linha para copiar o caminho.
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.
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.
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) 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.
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)) 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.
# 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.
| Sintoma | Causa | Soluçã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.
Conversores
Formatar e validar
Converter por caso de uso
- Kubernetes Transforme a saída JSON do kubectl e objetos da API em manifests limpos, prontos para aplicar.
- Docker Compose Gere o compose.yaml a partir de JSON, incluindo portas, variáveis de ambiente e volumes.
- GitHub Actions Escreva arquivos de workflow a partir de JSON sem cair na armadilha on: / true.
- OpenAPI / Swagger Converta especificações OpenAPI 3 e Swagger 2.0 entre JSON e YAML.
- CloudFormation Converta templates do AWS CloudFormation de JSON para YAML, incluindo funções intrínsecas.
Guias de código e linha de comando
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.