De registros para linhas
APIs e bancos de dados exportam listas de registros como arrays JSON: [{"id":1,"nome":"Ana"}, …]. Planilhas querem linhas e colunas. Este conversor gera uma linha por registro e uma coluna por campo, montando o cabeçalho com todas as chaves que aparecem em qualquer registro, então um campo que só existe em alguns registros também ganha sua coluna.
Objetos aninhados viram colunas com nomes pontuados: {"endereco":{"cidade":"Recife"}} vira a coluna endereco.cidade. Listas dentro de um registro ficam como texto JSON numa única célula.
Exemplo resolvido
[{"id":1,"nome":"Ana","cidade":{"nome":"Recife"}},
{"id":2,"nome":"Silva; João","vip":true}]
com o delimitador ponto e vírgula vira
id;nome;cidade.nome;vip
1;Ana;Recife;
2;"Silva; João";;true
Silva; João fica entre aspas porque contém o delimitador. No Brasil, o Excel costuma esperar ponto e vírgula, porque a vírgula é o separador decimal.
Como funciona
A página lê o JSON de forma estrita, achata objetos aninhados com caminhos pontuados e monta o cabeçalho com a união das chaves, na ordem em que aparecem. Cada valor vai para sua coluna; valores ausentes e null viram células vazias. Seguindo a RFC 4180, um campo fica entre aspas duplas quando contém o delimitador, aspas, quebra de linha ou espaços nas pontas, e as aspas internas são duplicadas. As linhas terminam com CRLF. Use CSV para JSON no caminho inverso. Tudo roda nesta aba.
Perguntas frequentes
Por que o Excel mostra tudo numa coluna só?
O Excel brasileiro usa ponto e vírgula como separador de lista, porque a vírgula é decimal. Escolha o delimitador ponto e vírgula.
Como ficam os objetos aninhados?
Viram colunas com nomes pontuados, como endereco.cidade. Listas ficam como texto JSON numa célula.
E se os registros tiverem campos diferentes?
O cabeçalho inclui todas as chaves de todos os registros, e os valores ausentes ficam vazios.
Meus dados são enviados?
Não. A conversão roda no navegador.
Fontes
- RFC 4180 — Common Format and MIME Type for CSV Files
- RFC 8259 — The JavaScript Object Notation (JSON) Data Interchange Format
- Wikipedia — Comma-separated values
Revisado em 17 de out. de 2026 · vetores de teste fixtures/dev/json-to-csv/