Como formatar JSON: 3 formas confiáveis de deixar legível e válido (Guia 2026)

O que “formatar JSON” realmente faz

O JSON que vem de uma API ou de um arquivo de log costuma estar minificado: o documento inteiro espremido em uma única linha, sem espaços. Continua sendo JSON válido, só que ilegível. Formatar (também chamado de pretty-print ou embelezar) o expande de volta em linhas indentadas para você ver a estrutura: objetos dentro de objetos, arrays de itens e onde cada um termina.

Às vezes se confunde com validar, e os dois costumam andar juntos. Validar responde “isto é JSON legal?”, formatar responde “um humano consegue ler?”. Bons formatadores fazem os dois de uma vez: se seu JSON tiver um erro de sintaxe, o formatador para e aponta a linha em vez de produzir lixo em silêncio.

Método 1: Formatador online gratuito (o mais rápido)

Para um caso pontual — colar uma resposta de API ou um trecho de log — uma ferramenta online é o caminho mais rápido: sem instalar nada, sem código. Prefira uma que rode inteiramente no seu navegador (lado cliente) para que seus dados nunca saiam do seu dispositivo; isso importa se o JSON contém tokens, e-mails ou dados sensíveis.

Cole seu JSON no formatador (ou arraste um arquivo .json).
Clique em Formatar: a ferramenta aplica a indentação, colore a sintaxe e sinaliza erros com o número da linha.
Copie o resultado formatado de volta para o editor, ou use o botão Minificar se precisar da versão compacta para produção.

Método 2: Seu editor de código (o hábito diário)

Se você mexe com JSON com frequência, formatar dentro do editor é um toque de tecla. No VS Code, abra o arquivo .json e pressione Shift+Alt+F (Windows/Linux) ou Shift+Option+F (Mac) — “Formatar documento”. O VS Code também pode formatar ao salvar se você ativar Editor: Format On Save.

A maioria dos editores precisa de um plugin para o trabalho avançado com JSON, mas a formatação básica já vem no VS Code, no Sublime Text (via pacotes) e nas IDEs da JetBrains.

Método 3: Comando de terminal (repetível)

Quando o JSON mora em um arquivo e você quer o mesmo resultado sempre — num script, numa etapa de deploy ou só rapidinho na linha de comando — um one-liner vence qualquer clique.

Terminal

# Exibir data.json formatado no terminal
python3 -m json.tool data.json

# Escrever a versão formatada num arquivo novo
python3 -m json.tool data.json > data.pretty.json

# A mesma ideia com jq, se você o tiver instalado
jq . data.json

O python3 -m json.tool também valida: ele sai com erro e número da linha quando o arquivo não é um JSON válido, o que o torna uma checagem rápida dentro de scripts.

Pretty-print vs minificado: quando usar cada um

O JSON bem formatado é para humanos: depuração, arquivos de configuração editados à mão, exemplos na documentação. O JSON minificado é para máquinas: respostas de API, arquivos de produção, tudo em que bytes e velocidade de parse importam.

Converta entre os dois livremente — são os mesmos dados. Só evite editar à mão a versão minificada: expanda primeiro, faça sua mudança e minifique de novo se o consumidor precisar dela compacta.

Erros comuns que a formatação revela

Nove em cada dez vezes, um formatador “falhando” é a coisa mais útil que ele pode fazer. Estes são os culpados que ele vive encontrando:

Vírgulas finais — {"a": 1,} é ilegal em JSON (vale em JavaScript). Apague a vírgula antes do colchete de fechamento.
Aspas simples — strings JSON precisam de aspas duplas. Troque 'valor' por "valor".
Comentários — // e /* */ não fazem parte do JSON. Remova-os ou mude o arquivo para JSONC/JSON5 se sua ferramenta suportar.
Chaves sem aspas — {nome: "x"} precisa virar {"nome": "x"}.
Danos de copiar-colar — aspas tipográficas de apps de chat e documentos (“ ”) não são caracteres de aspas válidos; substitua por aspas retas.

Próximo passo: leve seu JSON formatado para a planilha

Quando seu JSON está legível e válido, o próximo passo costuma ser levá-lo para uma planilha — e é exatamente o que nosso conversor gratuito faz: ele achata seu JSON num CSV limpo, pronto para planilhas, em segundos, com a mesma privacidade sem uploads.

Leia: Como converter JSON em CSV

Guias relacionados

Perguntas frequentes

Formatar é o mesmo que validar JSON?

Não, mas há sobreposição. Validar checa se seu JSON segue as regras de sintaxe; formatar o reescreve com indentação e quebras de linha para humanos lerem. A maioria dos formatadores valida primeiro — eles não formatam um documento com erro de sintaxe, por isso uma formatação que falha geralmente significa JSON inválido.

Formatar muda meus dados?

Não. Formatar só muda espaços em branco: indentação, quebras de linha e espaços. Chaves, valores, ordem e tipos ficam exatamente iguais — a menos que você ative explicitamente extras como ordenação de chaves, que algumas ferramentas oferecem como opção separada.

O que significa “Unexpected token” ao formatar JSON?

Significa que o parser encontrou um caractere que não consegue encaixar — quase sempre uma vírgula final, uma string com aspas simples, uma chave sem aspas ou uma aspa tipográfica colada de um app de chat. A mensagem de erro costuma incluir uma posição; corrija aquele ponto, formate de novo e o próximo erro (se houver) vai aparecer.

Dá para formatar JSON sem instalar nada?

Sim. Use um formatador online gratuito que rode no seu navegador, ou o one-liner python3 -m json.tool se o Python já estiver na sua máquina. O VS Code também formata arquivos .json nativamente com Shift+Alt+F.

É seguro colar JSON num formatador online?

Geralmente sim, mas escolha um que processe tudo no seu navegador (lado cliente) — assim nada é enviado para lugar nenhum. Se o JSON contém chaves de API, dados pessoais ou algo que você não enviaria por e-mail, use seu editor ou o comando de terminal.

O que é JSON minificado?

JSON com todo o espaço em branco desnecessário removido: o documento inteiro numa linha só. APIs e arquivos de produção usam porque é menor e faz parse um pouco mais rápido. É JSON válido — só não foi feito para olhos humanos. Qualquer formatador pode expandi-lo de volta para a versão legível.

A formatação funciona com arquivos JSON enormes?

Sim, com limites. Formatadores de navegador lidam bem com alguns megabytes; além disso, podem congelar a aba. Para arquivos grandes, formate localmente com python3 -m json.tool ou jq, que processam arquivos grandes sem suar.