Como funciona o Conversor TXT ↔ CSV ↔ JSON
O Conversor TXT ↔ CSV ↔ JSON do ModelosHub é uma ferramenta gratuita, totalmente client-side, que transforma dados estruturados entre os três formatos mais utilizados no dia a dia de desenvolvedores, analistas de dados, profissionais de marketing e administradores de sistemas. Você cola ou faz upload do conteúdo, escolhe o sentido da conversão e baixa o resultado em segundos.
Diferente de soluções online que pedem cadastro ou enviam seus dados para um servidor remoto, aqui tudo acontece dentro do seu navegador. Nenhum byte é transmitido para fora da sua máquina. Isso é especialmente importante quando você lida com dados sensíveis: planilhas de clientes, exportações de banco de dados, listas de e-mails, registros financeiros. A conversão é feita por JavaScript executado localmente, com algoritmos que detectam delimitadores, escapam aspas corretamente e preservam acentos em UTF-8 e ISO-8859-1.
A ferramenta cobre cinco sentidos de conversão principais: CSV para JSON, JSON para CSV, TXT (delimitado) para CSV, CSV para TXT e JSON para TXT (formato legível em lista). Cada sentido foi pensado para um caso de uso real, desde transformar um export de planilha em um array de objetos JSON pronto para alimentar uma API, até pegar uma resposta JSON da sua API e gerar um CSV para abrir no Excel.
Formato e estrutura dos arquivos
Antes de converter, vale entender os três formatos. O CSV (Comma-Separated Values) é um arquivo de texto onde cada linha representa um registro e cada campo é separado por um delimitador, normalmente vírgula no padrão internacional ou ponto-e-vírgula no padrão brasileiro (já que usamos vírgula como separador decimal). Quando um campo contém o próprio delimitador, ele é envolvido por aspas duplas, e aspas internas são duplicadas.
O JSON (JavaScript Object Notation) é um formato hierárquico de pares chave-valor. Para representar tabelas, normalmente usa-se um array de objetos, onde cada objeto tem as mesmas chaves (os cabeçalhos do CSV) e valores correspondentes àquela linha. JSON é o formato dominante em APIs REST e em arquivos de configuração modernos.
O TXT delimitado é uma variação livre do CSV: pode usar tabulação, pipe (|), ponto-e-vírgula ou qualquer outro caractere. É comum em exportações de sistemas legados, dumps de banco de dados via SQL e relatórios gerados por mainframes. O nosso conversor detecta o delimitador automaticamente quando você escolhe "Detectar automaticamente", contando ocorrências de cada candidato na primeira linha não vazia.
Exemplos práticos de conversão
Exemplo 1: CSV brasileiro para JSON. Suponha um arquivo com a primeira linha "nome;idade;cidade" e linhas como "João;30;São Paulo". Após colar o conteúdo, escolher delimitador "Ponto-e-vírgula" e cabeçalho "Sim", a ferramenta gera um JSON como [{"nome":"João","idade":"30","cidade":"São Paulo"}, ...]. Esse formato pode ser usado em qualquer aplicação JavaScript, Node.js, Python (com json.loads), PHP (json_decode) ou linguagem moderna.
Exemplo 2: JSON para CSV para abrir no Excel. Sua API REST retorna um array de produtos. Você cola o JSON, escolhe "JSON → CSV" e a ferramenta extrai todas as chaves únicas como cabeçalho, monta cada linha respeitando a ordem e baixa um arquivo .csv pronto para abrir no LibreOffice Calc ou Excel. Lembre-se de escolher o delimitador certo: se vai abrir em Excel pt-BR, use ponto-e-vírgula.
Exemplo 3: TXT de log para CSV organizado. Um sistema legado exporta logs separados por tabulação. Cole o conteúdo, escolha "TXT → CSV", delimitador "Tab" e cabeçalho "Sim" se a primeira linha tiver os nomes das colunas. O resultado vem com vírgulas (ou o delimitador que você escolher na saída), pronto para análise.
Exemplo 4: JSON aninhado. Quando o JSON tem objetos dentro de objetos, a ferramenta achata um nível usando notação ponto (por exemplo, "endereco.cidade"). Estruturas muito profundas devem ser pré-processadas, mas para a maioria dos casos de exportação de dados isso resolve.
Exemplo 5: CSV com campos contendo vírgula. Campos como "São Paulo, SP" são automaticamente envolvidos em aspas duplas na saída CSV, e a leitura interpreta corretamente quando o campo está entre aspas. Isso evita o erro clássico de quebrar a tabela ao meio.
Quando usar cada conversão
Use CSV → JSON quando precisar consumir uma planilha em uma aplicação web, popular um banco de dados via script, ou integrar dados de marketing com APIs. JSON é o formato universal para troca de dados estruturados na web moderna.
Use JSON → CSV quando precisar entregar dados de uma API para alguém que vai analisar em Excel, Google Sheets ou Power BI. Stakeholders não-técnicos preferem planilhas e essa conversão evita o trabalho manual de extrair campos um a um.
Use TXT → CSV ao migrar dados de sistemas legados, mainframes ou exports de ERP antigos. Muitos sistemas brasileiros ainda exportam em TXT com pipe ou tab; transformar em CSV padronizado facilita a análise downstream.
Use CSV → TXT para gerar relatórios em formato legível, ou para alimentar sistemas que esperam delimitadores específicos (pipe é comum em fluxos bancários, tabulação em scripts shell).
Use JSON → TXT quando quiser ler rapidamente o conteúdo de um JSON sem se preocupar com sintaxe. O resultado é um texto formatado em lista, ideal para revisar dados antes de processar.
Cuidados ao converter dados
Verifique sempre o encoding do arquivo original. CSVs gerados por Excel em Windows costumam usar ISO-8859-1 (Latin-1), enquanto sistemas Unix e a web preferem UTF-8. Acentos e cedilhas aparecerem como "?" ou caracteres estranhos é sinal de encoding errado. Se o resultado vier corrompido, abra o arquivo original num editor de texto que mostre o encoding (VS Code, Notepad++) e salve como UTF-8 antes de colar.
Cuidado com números formatados como texto. Um campo "R$ 1.234,56" é uma string, não um número. Se você precisar fazer cálculo depois, é melhor exportar do sistema de origem já como número puro (1234.56) ou tratar a conversão em script.
Atenção a datas. Não há um padrão universal: 03/04/2026 pode ser 3 de abril ou 4 de março. O ideal é trabalhar em ISO-8601 (2026-04-03), que é inequívoco e ordenável alfabeticamente.
JSONs muito grandes (acima de 10 MB) podem travar o navegador. Para datasets enormes, use scripts em Python (pandas) ou Node.js, que processam em streaming. Esta ferramenta foi otimizada para arquivos de até cerca de 5 MB.
Por fim, sempre valide o resultado. Abra o CSV gerado em uma planilha, conte o número de linhas, confira se nenhum campo "quebrou" para uma linha extra (sinal de aspas mal escapadas no original).
Perguntas frequentes
Meus dados são enviados para o servidor?
Não. Toda a conversão acontece no JavaScript do seu navegador. Você pode até desconectar a internet depois de carregar a página e a ferramenta continua funcionando.
Qual o tamanho máximo de arquivo?
Tecnicamente não há limite, mas recomendamos até 5 MB para conforto. Acima disso o navegador pode ficar lento durante a conversão.
O conversor entende JSON aninhado?
Sim, ele achata um nível usando notação ponto. Estruturas com arrays dentro de objetos são serializadas como string JSON dentro da célula.
Posso escolher vírgula decimal no CSV brasileiro?
Os campos numéricos são preservados como vieram. Se o original tem vírgula decimal, ela é mantida. Recomendamos delimitador ponto-e-vírgula nesse caso para não conflitar.
Funciona em celular?
Sim, a interface é responsiva. Para arquivos grandes, o desktop tem mais memória disponível.
E se meu CSV usar aspas simples ao invés de duplas?
O padrão RFC 4180 é aspas duplas. Se seu arquivo usa aspas simples, faça um find-replace antes ou nos avise para suportar esse formato.
Posso converter Excel direto?
Não diretamente — arquivos .xlsx são binários comprimidos. Exporte como CSV no próprio Excel (Arquivo > Salvar Como > CSV UTF-8) e depois cole aqui.
Suporta TSV (tab-separated values)?
Sim. Escolha delimitador "Tabulação". TSV é praticamente um CSV com tab no lugar de vírgula, muito comum em exports do Google Analytics e bancos PostgreSQL.
O resultado preserva ordem dos campos?
Sim. Na conversão CSV → JSON a ordem dos cabeçalhos vira a ordem das chaves do objeto. Na conversão JSON → CSV, a ferramenta usa a ordem das chaves do primeiro objeto e completa com chaves que aparecem só nos objetos seguintes.
Comparação com outras ferramentas
Existem várias soluções para conversão de dados. Vale entender quando usar cada uma. Excel ou LibreOffice Calc abrem CSV mas têm várias limitações: mudam vírgula decimal automaticamente para ponto, "corrigem" zeros à esquerda (códigos como "01234" viram "1234"), interpretam datas no formato regional. Para análise visual servem; para conversão técnica entre formatos, atrapalham mais que ajudam.
Scripts em Python com pandas são poderosíssimos para volumes grandes e transformações complexas (renomear colunas, filtrar linhas, juntar tabelas). Mas exigem instalar Python, escrever código e debugar erros de encoding. Para conversões rápidas e diretas, é overkill.
Conversores online tradicionais exigem upload do arquivo para servidor. Isso é problemático com dados sensíveis: cadastros de clientes, registros financeiros, qualquer coisa sob LGPD. Nossa ferramenta client-side resolve esse ponto crítico — seu dado nunca sai do navegador, não há log no servidor, não há possibilidade de vazamento por brecha em terceiro.
jq (linha de comando) é fenomenal para JSON, mas tem curva de aprendizado. Vale o investimento para devs que mexem com JSON o dia inteiro; pra uma conversão pontual, a interface visual desta ferramenta é mais produtiva.
Dicas avançadas para devs
Quando você precisa integrar com pipeline de dados, esta ferramenta cobre a etapa de inspeção e conversão pontual. Para automação contínua, considere encadear: API → JSON → conversão programática → CSV → carga em BI. Esta ferramenta é o "olho humano" no meio do pipeline, útil para validar amostras antes de rodar em volume.
Para JSON com arrays aninhados (tipo `[{"id":1,"tags":["a","b"]}]`), a serialização para CSV transforma o array em string JSON dentro da célula: `"[\"a\",\"b\"]"`. Você precisa decidir downstream se quer explodir essa coluna em múltiplas linhas (one-hot) ou tratar como texto. A ferramenta entrega o JSON serializado; a decisão de modelagem fica com você.
Para CSVs muito largos (centenas de colunas) gerados por sistemas tipo Salesforce, o navegador pode ficar pesado. Tente trabalhar em chunks: divida o arquivo em duas metades de linhas, converta separado e una depois.
Sobre encoding misto (parte do arquivo em UTF-8, parte em Latin-1) — isso é raro mas acontece em arquivos concatenados manualmente. Não há ferramenta que resolva isso 100% sem intervenção; geralmente é preciso identificar o ponto de quebra e converter cada metade separadamente.