Como Formatar JSON Online

O que significa "formatar" JSON?

O JSON que vem de APIs, bancos de dados ou arquivos de log geralmente está minificado — tudo em uma única linha sem espaços além do necessário. Isso é ótimo para máquinas, mas difícil de ler ao depurar. Formatar JSON (também chamado de embelezar, identar ou fazer o pretty print) adiciona espaço em branco — quebras de linha e indentação — para tornar a estrutura visível.

O fato principal sobre a formatação de JSON: ela muda apenas o espaço em branco, nunca os dados. Um parser JSON trata estas duas strings de forma idêntica:

{"nome":"Alice","idade":30,"cargos":["admin","editor"]}

{
  "nome": "Alice",
  "idade": 30,
  "cargos": [
    "admin",
    "editor"
  ]
}

A segunda forma ocupa mais bytes, mas ambas resultam no mesmo valor quando analisadas. A formatação é puramente cosmética.

Quando você precisa formatar JSON?

Os desenvolvedores geralmente usam um formatador online nestas situações:

• Depurando uma resposta de API. Você fez uma requisição com curl ou Postman e a resposta é um bloco de texto ilegível. Cole em um formatador para ver a estrutura.
• Lendo uma exportação de banco de dados. JSON armazenado em colunas de banco ou exportado do MongoDB/DynamoDB costuma ser compacto. Formate para entender o esquema.
• Revisando um arquivo de configuração. Um colega enviou um config JSON difícil de ler. Formate antes de revisar.
• Preparando JSON para commit. Você quer normalizar a indentação de um arquivo JSON antes de fazer o commit no controle de versão.

Como formatar JSON online, passo a passo

1. Abra o formatador. Acesse json-indent.com/pt/. Sem necessidade de conta.
2. Cole seu JSON. Clique no painel de entrada à esquerda e cole seu JSON (Ctrl+V / Cmd+V). A formatação acontece automaticamente.
3. Escolha o tamanho da indentação. Use o menu suspenso no painel de saída para alternar entre 2 espaços, 4 espaços ou tab.
4. Verifique erros. Se o JSON for inválido, a linha com erro é destacada e o painel de saída mostra o problema exato.
5. Copie ou baixe. Clique em Copiar ou Baixar para salvar o resultado como arquivo .json.

Escolhendo o tamanho da indentação

As três escolhas comuns — 2 espaços, 4 espaços, tab — produzem dados idênticos:

• 2 espaços é o mais comum para arquivos JSON especificamente. Comunidades JavaScript e Node.js usam por padrão. JSON.stringify(obj, null, 2) usa 2 espaços. Em caso de dúvida, escolha este.
• 4 espaços é padrão em Python (PEP 8) e comum em Java e C#. Se o arquivo JSON pertence a um repositório Python ou Java, 4 espaços é mais natural.
• Tab é usado em Go (onde gofmt aplica tabs) e algumas convenções PHP. Tabs permitem que cada desenvolvedor configure sua própria largura de exibição.

Como formatar JSON em código

Python

import json
data = json.loads(json_string)
print(json.dumps(data, indent=2, ensure_ascii=False))

JavaScript / Node.js

const data = JSON.parse(jsonString);
console.log(JSON.stringify(data, null, 2));

Linha de comando

# Usando Python (sem instalação extra)
python3 -m json.tool data.json

# Usando jq (instalar com brew ou apt-get)
cat data.json | jq '.'

Formate JSON no navegador — grátis

Cole qualquer JSON e obtenha o resultado formatado instantaneamente. Sem cadastro. 100% no navegador.

Perguntas Frequentes