Por que formatar JSON ou YAML?
Se você trabalha com API REST ou pipelines CI/CD, manipula JSON e YAML várias vezes por dia. Um JSON compacto copiado de uma resposta de API é difícil de ler; um YAML mal indentado quebra um deploy no Kubernetes. Minificar JSON reduz o tamanho do payload de 30 a 60 % eliminando espaços e quebras de linha.
Três casos de uso comuns:
- Debug de API → Pretty-Print de um payload JSON minificado para ler os campos e identificar um erro
- Conversão de config → Transformar um JSON em YAML para um
docker-compose.ymlou um manifest Kubernetes - Validação rápida → Verificar se um documento JSON ou YAML não contém erros de sintaxe
Como usar o JSON / YAML Formatter em 3 etapas
Etapa 1: Colar o conteúdo
Cole seu JSON ou YAML na área de entrada. A ferramenta aceita documentos de até 1 MB.
Etapa 2: Escolher a operação
Selecione o modo adequado:
- Formatar JSON: Pretty-Print com indentação de 2 espaços (padrão) ou minify
- JSON → YAML: conversão completa para YAML
- Formatar YAML: normaliza a indentação YAML
- YAML → JSON: conversão para JSON indentado
Etapa 3: Obter o resultado
Clique em "Formatar / Converter". O resultado aparece na área de saída. Copie-o diretamente.
O que é JSON e YAML?
JSON (RFC 8259) é um formato textual estruturado (objetos, arrays, escalares). É o padrão dominante das APIs REST e da troca de dados na web.
YAML (spec 1.2) é um superconjunto de JSON, mais legível graças à indentação. É o padrão para configs do Kubernetes, Docker Compose, GitHub Actions, GitLab CI e Ansible. Todo JSON válido também é YAML válido.
Exemplo de conversão:
{
"name": "captaindns.com",
"records": [
{"type": "A", "value": "93.184.216.34"},
{"type": "MX", "value": "mail.captaindns.com"}
]
}
Convertido em YAML:
name: captaindns.com
records:
- type: A
value: 93.184.216.34
- type: MX
value: mail.captaindns.com
Quais operações a ferramenta suporta?
| Operação | Entrada | Saída | Uso típico |
|---|---|---|---|
| Formatar JSON | JSON compacto ou mal indentado | JSON indentado (2 ou 4 espaços) ou minificado | Debug de API, legibilidade |
| JSON → YAML | JSON válido | YAML formatado | Criar um docker-compose, manifest K8s |
| Formatar YAML | YAML com indentação irregular | YAML normalizado | Limpar uma config antes do commit |
| YAML → JSON | YAML válido | JSON indentado ou minificado | Preparar um payload de API a partir de uma config YAML |
Casos de uso reais
Cenário 1: Depurar uma resposta de API
Sintoma: Você recebe um payload JSON minificado de 500 caracteres em uma única linha. Diagnóstico: Cole o JSON e selecione "Formatar JSON". Ação: O JSON é indentado e legível. Identifique o campo com erro em segundos.
Cenário 2: Converter uma config Terraform em YAML
Sintoma: Você tem um output JSON de um terraform output -json e precisa integrá-lo em um arquivo YAML.
Diagnóstico: Cole o JSON e selecione "JSON → YAML".
Ação: Copie o YAML gerado diretamente no seu arquivo de config.
Cenário 3: Validar um docker-compose.yml
Sintoma: Um docker compose up falha com um erro de parsing.
Diagnóstico: Cole o YAML e selecione "Formatar YAML". Se o YAML for inválido, a ferramenta indica o erro.
Ação: Corrija o erro identificado e reinicie o deploy.
❓ FAQ - Perguntas frequentes
P: Qual é o tamanho máximo aceito?
R: A ferramenta aceita documentos JSON ou YAML de até 1 MB. Para arquivos maiores, utilize jq (JSON) ou yq (YAML) na linha de comando.
P: A ferramenta valida a sintaxe JSON?
R: Sim. Se o JSON for inválido, a ferramenta retorna um erro explícito (ERR_INVALID_JSON_INPUT) com uma mensagem descritiva.
P: Qual é a diferença entre JSON e YAML?
R: JSON usa chaves, aspas e vírgulas. YAML usa indentação e é mais legível para humanos. YAML é um superconjunto de JSON.
P: O que significa minificar JSON?
R: Minificar remove todos os espaços e quebras de linha desnecessários para obter um JSON compacto em uma única linha.
P: Como a ferramenta lida com chaves não-string em YAML?
R: YAML permite chaves numéricas ou booleanas (true: value, 42: data). Na conversão para JSON, elas são automaticamente convertidas em strings.
P: Meus dados são armazenados?
R: Não. O conteúdo é processado em memória e excluído imediatamente após a resposta.
P: Posso usar esta ferramenta para validar um arquivo Kubernetes?
R: A ferramenta valida a sintaxe YAML, não o esquema Kubernetes. Utilize kubectl apply --dry-run para validação de esquema.
Ferramentas complementares
| Ferramenta | Utilidade |
|---|---|
| Codificador / decodificador Base64 | Codificar payloads JSON em Base64 para transporte |
| Codificador / decodificador URL | Codificar JSON em uma query string URL |
| Regex Tester | Extrair valores de um JSON com expressões regulares |
| Hash Generator | Calcular o hash de um documento JSON para verificar a integridade |
Recursos úteis
- RFC 8259 - The JSON Data Interchange Format (especificação oficial JSON)
- YAML 1.2 Specification (especificação oficial YAML)
- jq - Command-line JSON processor (ferramenta CLI para manipular JSON)
- yq - Command-line YAML processor (ferramenta CLI para manipular YAML)