O que é XML, CSV, JSON e YAML: cada arquivo e os cuidados na conversão

O que é um arquivo XML, CSV, JSON e YAML, como abrir cada um, quando usar cada formato e os cuidados com delimitadores, cabeçalhos, aspas, arrays e estruturas aninhadas na conversão.

Revisão técnica: Cesar GargiuloRFC 4180 / RFC 8259 / Especificação YAML
Calcule agora: Conversor de dadosResultado na hora, de graça e sem cadastro.

XML, CSV, JSON e YAML são quatro jeitos de gravar dados como texto. O CSV guarda tabela, o JSON guarda os objetos que as APIs trocam, o YAML guarda configuração e o XML guarda documentos com tags, de planilha do Office a mapa de site. Saber o que é cada arquivo explica por que a conversão entre eles quebra nos mesmos pontos: delimitadores, cabeçalhos, aspas e estruturas aninhadas. A seguir estão o que é um arquivo XML e um arquivo CSV, como abrir cada um, quando usar cada formato e como converter sem perder estrutura. Para converter agora, use o conversor de dados, que roda 100% no navegador.

Resposta rápida

  • CSV = tabela (planilhas); JSON = APIs; YAML = configuração; XML = sistemas corporativos/legados.
  • No CSV, cuide do delimitador (vírgula x ponto e vírgula) e das aspas em campos com vírgula.
  • CSV é plano: estruturas aninhadas precisam ser achatadas ao converter para CSV.
  • Mantenha como texto campos com zero à esquerda (CEP, CPF) e padronize UTF-8.

O que é um arquivo XML

XML (Extensible Markup Language) é um formato de texto que guarda dados com tags que abrem e fecham, como <cliente>Maria</cliente>. Cada tag diz o que o dado é, e uma tag dentro da outra forma a hierarquia: um pedido contém itens, cada item contém nome e preço. As tags não são fixas como as do HTML, e cada sistema define as suas. A especificação é do W3C, que publicou a quinta edição do XML 1.0 em 2008. Um arquivo .xml é texto puro: abre no Bloco de Notas, no VS Code ou no próprio navegador, que mostra a árvore de tags.

O formato está em toda parte, mesmo quando ninguém o vê. Os arquivos .docx do Word e .xlsx do Excel são pacotes compactados de XML, no padrão Office Open XML. O sitemap.xml que os buscadores leem segue um protocolo em XML, e as imagens SVG também são XML. Se o arquivo que você procura é o da nota fiscal eletrônica, ele é o próprio documento fiscal, assinado digitalmente, e o lugar de consultá-lo é o Portal da Nota Fiscal Eletrônica ou a secretaria da Fazenda (SEFAZ) do seu estado, sem editar o conteúdo.

O que é um arquivo CSV

CSV (comma-separated values, ou valores separados por vírgula) é uma tabela escrita como texto: cada linha do arquivo é uma linha da planilha, e um separador divide as colunas. A RFC 4180, de outubro de 2005, descreve o formato com a vírgula como separador e pede aspas duplas em volta do campo que contém vírgula, aspas ou quebra de linha. Na prática brasileira, o Excel salva com ponto e vírgula, porque a vírgula já é o separador decimal.

O arquivo abre no Excel, no LibreOffice Calc e no Google Planilhas, que mostram as colunas, e em qualquer editor de texto, que mostra o conteúdo bruto. Vale abrir no editor antes de converter: é ali que aparece qual separador o arquivo usa e se o campo com vírgula veio entre aspas. Para transformar a tabela em JSON, use o conversor CSV to JSON, que reconhece o separador sozinho e mantém o zero à esquerda de CPF e CEP.

Diferença entre CSV, JSON, YAML e XML

Os quatro guardam dados, mas com filosofias diferentes:

FormatoEstruturaHierarquiaUso típico
CSVTabela (linhas/colunas)NãoPlanilhas, exportações
JSONObjetos e listasSimAPIs web, front-end
YAMLIndentaçãoSimConfiguração (CI, Kubernetes)
XMLTags + atributosSimIntegrações corporativas/legado

Quando cada formato é mais usado

Use CSV quando o destino é uma planilha ou um sistema que espera tabela. Use JSON para comunicação entre serviços e front-end. Use YAML para configurar pipelines e ambientes, onde a legibilidade importa. Use XML quando o sistema do outro lado exige, como em integrações bancárias, fiscais ou padrões antigos. Saber o destino evita conversões desnecessárias e perda de estrutura.

CSV para JSON: cabeçalhos, delimitadores e aspas

Ao converter CSV para JSON, três decisões importam. Primeiro, se a primeira linha é cabeçalho: nesse caso cada coluna vira uma chave do objeto. Segundo, o delimitador: vírgula é o padrão internacional, mas planilhas em português costumam usar ponto e vírgula. Terceiro, as aspas: campos com vírgula ou quebra de linha precisam estar entre aspas duplas, e aspas internas são duplicadas. Um bom conversor coage tipos com cuidado, lendo 30 como número e true como booleano, mas mantendo textos intactos.

No conversor de CSV para JSON do ValorFinal, o delimitador sai do próprio arquivo: é o caractere que dá o mesmo número de colunas em todas as linhas. A prévia em tabela mostra se o cabeçalho foi lido certo antes de você baixar. Na tipagem, uma célula só vira número quando, escrita de volta, fica igual à original. Por isso 00845678909 continua texto, e 315.5 vira número.

JSON para CSV: arrays, objetos e campos aninhados

O caminho inverso esbarra na natureza plana do CSV. Um array de objetos com as mesmas chaves vira uma tabela direta, em que cada chave é uma coluna. Quando há objetos ou arrays aninhados, o conversor precisa achatar a estrutura ou colocar um JSON como texto na célula. Na exportação, atenção à segurança: células iniciadas por sinais de fórmula devem ser neutralizadas para evitar CSV injection ao abrir o arquivo em um editor de planilhas.

O conversor de JSON para CSV do ValorFinal escreve o objeto interno como JSON dentro da célula e põe um apóstrofo na frente do texto que começa com =, +, - ou @. Número negativo como -5 fica como está, porque planilha nenhuma executa número. As duas mudanças aparecem num aviso junto do resultado.

JSON para YAML e YAML para JSON

Como YAML e JSON representam as mesmas estruturas, a conversão entre eles é a mais direta. O YAML resultante fica mais legível, com indentação no lugar de chaves e colchetes. No sentido inverso, o JSON é mais fácil de processar por máquinas. Cuide apenas dos recursos avançados de YAML, que nem sempre têm equivalente em JSON. Para converter JSON para YAML sem arredondar identificador longo, o número precisa ser copiado como foi escrito: quem lê o JSON com o JSON.parse do JavaScript transforma 9007199254740993 em 9007199254740992 antes de escrever o YAML.

XML para JSON e JSON para XML

Converter XML para JSON exige decidir como tratar atributos e texto. Uma convenção comum coloca atributos em uma chave especial, como @attributes, e o texto do elemento em outra, como #text. Elementos repetidos com o mesmo nome viram um array. No caminho JSON para XML, cada chave do objeto vira uma tag, e caracteres especiais como menor que, maior que e o e comercial precisam ser escapados como entidades.

Erros comuns em conversão

Exemplo prático

Um CSV com cabeçalho como este:

nome,idade,ativo
Maria,30,true

vira o seguinte JSON, com tipos coagidos:

[
  { "nome": "Maria", "idade": 30, "ativo": true }
]

Tipos de dados e perda de informação

Um detalhe que costuma passar despercebido é como cada formato trata tipos. No CSV, tudo é texto: o número 30 e a string 30 são iguais, e cabe a quem lê decidir como interpretar. Ao converter para JSON, um bom conversor coage valores, lendo 30 como número e true como booleano, mas isso pode causar surpresas, por exemplo transformar um CEP com zero à esquerda em um número e perder o zero. Quando a fidelidade importa, mantenha esses campos como texto.

JSON, YAML e XML representam tipos com mais riqueza, mas também têm armadilhas. Datas, por exemplo, não têm um tipo nativo em JSON e costumam virar texto em um formato combinado. Números muito grandes podem perder precisão. Em XML, tudo é texto por padrão, e a interpretação depende de um esquema. Por isso, depois de converter dados importantes, confira uma amostra do resultado antes de confiar na transformação inteira.

Outra recomendação prática é padronizar a codificação em UTF-8. Acentos e caracteres especiais que aparecem corrompidos quase sempre indicam um problema de codificação na origem, não na conversão. Ao colar dados de planilhas, confira se acentos e cedilha vieram corretos. Pequenos cuidados com tipos e codificação evitam a maior parte dos erros silenciosos em integrações de dados.

Checklist antes de converter

Antes de rodar uma conversão importante, vale seguir um roteiro rápido. Confirme o delimitador real do CSV abrindo o arquivo em um editor de texto, e não só na planilha. Decida se a primeira linha é cabeçalho. Verifique se campos com vírgula ou quebra de linha estão entre aspas. Identifique os campos que devem permanecer como texto, como CEP, CPF, CNPJ e códigos com zero à esquerda. Por fim, converta uma amostra pequena primeiro e confira o resultado antes de processar o arquivo inteiro. Esse cuidado de poucos minutos evita retrabalho e dados corrompidos em integrações que rodam repetidamente, e é especialmente importante quando a saída alimenta outro sistema de forma automática.

Vale ainda combinar formatos conforme a etapa do trabalho. É comum receber um CSV de uma planilha, convertê-lo em JSON para tratar os dados em um script, e depois exportar de volta para CSV para entregar a quem usa planilha. Em arquivos de configuração, o caminho costuma ser o inverso: editar em YAML, por ser legível, e converter para JSON quando uma ferramenta exige. Saber transitar entre os formatos sem perder estrutura é o que torna o trabalho com dados mais rápido e menos sujeito a erro.

Quando usar a ferramenta do ValorFinal

Use o conversor de dados para converter entre CSV, JSON, YAML e XML com preview, cópia e download local. Para validar e formatar o JSON antes de converter, veja o formatador de JSON; para codificar conteúdo binário, o codificador Base64. Explore as demais ferramentas de tecnologia.

Fontes e referências

Conclusão

Converter entre CSV, JSON, YAML e XML é rotina, e o segredo é cuidar dos detalhes: delimitador, aspas, achatamento de aninhados, tipos e codificação UTF-8. Escolha o formato pelo destino e confira uma amostra antes de processar tudo. Use o conversor de dados, valide o JSON no formatador de JSON e conheça as demais ferramentas de tecnologia.

Calculadoras deste guia

As ferramentas de tecnologia mais procuradas no Google: teste de velocidade da internet, letras diferentes, horário de Brasília, cronômetro online, gerador de QR Code, roleta de sorteio, meu IP e gerador de CPF.

Leia também

Como citar esta página

Vai citar este guia em uma matéria, post ou trabalho? Copie a referência pronta. O conteúdo é baseado em RFC 4180 e revisado pela equipe editorial.

ValorFinal. O que é XML, CSV, JSON e YAML: cada arquivo e os cuidados na conversão. Disponível em: https://valorfinal.com.br/guia/converter-csv-json-yaml-xml. Atualizado em: 06/11/2026.

ValorFinal VIP: Sem anúncios no portal inteiro, cenários salvos e alertas por e-mail.

Como validamos este conteúdo

Base deste guia: RFC 4180 / RFC 8259 / Especificação YAML. Padrões, APIs, versões e recomendações técnicas evoluem. O conteúdo reflete a documentação de referência na data de atualização; confira sempre a documentação oficial da versão que você usa. Entenda nossa metodologia em como validamos os cálculos.

Perguntas frequentes

O que é um arquivo XML?
Arquivo XML é um texto que guarda dados com tags que abrem e fecham, como <nome>Maria</nome>, uma dentro da outra, formando uma hierarquia. A sigla vem de Extensible Markup Language, uma recomendação do W3C que está na quinta edição, de 2008. Ao contrário do HTML, as tags não são fixas: cada sistema cria as suas, e é por isso que o XML serve para trocar dados entre programas diferentes. O arquivo abre em qualquer editor de texto e no navegador, e pode ser convertido para JSON quando o destino é uma API.
O que é um arquivo CSV?
CSV é uma tabela gravada como texto: cada linha do arquivo é uma linha da planilha, e um separador, em geral a vírgula, divide as colunas. A sigla vem de comma-separated values, e a RFC 4180, de 2005, descreve o formato, com aspas duplas em volta do campo que contém vírgula, aspas ou quebra de linha. No Brasil, o Excel costuma salvar com ponto e vírgula, porque a vírgula é o separador decimal. O arquivo abre no Excel, no LibreOffice Calc, no Google Planilhas e em qualquer editor de texto.
Qual programa abre um arquivo XML?
Qualquer editor de texto abre XML, porque o arquivo é texto puro: o Bloco de Notas no Windows, o TextEdit no Mac e o VS Code ou o Notepad++ em qualquer sistema. O navegador também serve: arraste o arquivo para uma aba e o Chrome ou o Firefox mostram a árvore de tags. Se o XML vier todo numa linha só, um formatador reorganiza o recuo sem mudar o conteúdo. Para usar os dados numa planilha, converta o XML em JSON e depois em CSV, que o Excel abre direto.
O XML ainda é usado?
É, e mais do que parece. Os arquivos .docx e .xlsx do Office são pacotes compactados de XML, no padrão Office Open XML. O sitemap que os buscadores leem para conhecer as páginas de um site é um arquivo XML, e as imagens SVG também são XML. Em API nova, o JSON tomou o lugar do XML por ser mais curto e mais fácil de ler em JavaScript, mas integrações bancárias, fiscais e corporativas seguem com XML, que tem esquema de validação, namespaces e assinatura digital padronizados pelo W3C.
Qual a diferença entre XML e PDF?
XML guarda dados para programas lerem; PDF guarda a aparência de um documento para pessoas lerem e imprimirem. No XML, cada informação fica numa tag com nome, como <valor>150.00</valor>, e um sistema extrai e confere o campo sem esforço. No PDF, o mesmo valor é texto desenhado numa página, e tirar o número de lá exige ler o layout. Por isso, quando um sistema pede o XML, o PDF não serve no lugar: ele é só a representação visual do mesmo conteúdo.
Qual a diferença entre CSV, JSON, YAML e XML?
CSV é uma tabela simples de linhas e colunas, ótima para planilhas. JSON é um formato de objetos e listas, padrão em APIs web. YAML é parecido com o JSON em conteúdo, mas usa indentação e é muito usado em arquivos de configuração. XML usa tags aninhadas e atributos, comum em sistemas mais antigos e em alguns padrões corporativos.
Como o CSV trata vírgulas dentro de um campo?
Quando um campo contém vírgula, ele deve ficar entre aspas duplas. Se o próprio campo tiver aspas, elas são duplicadas. Por exemplo, o texto Silva, João vira "Silva, João". Um bom conversor respeita essas regras e ainda deixa escolher o delimitador (vírgula, ponto e vírgula ou tabulação), o que ajuda a colar dados de planilhas brasileiras.
É possível converter JSON aninhado para CSV?
Parcialmente. O CSV é plano, então estruturas aninhadas precisam ser achatadas ou representadas como texto na célula. Um conversor costuma transformar objetos e arrays internos em uma string JSON dentro da célula. Para dados muito aninhados, JSON, YAML ou XML preservam melhor a estrutura do que o CSV.
Converter YAML para JSON pode perder informação?
Para os casos comuns (mapas, listas, números, textos e booleanos), a conversão preserva os dados. Recursos avançados do YAML, como âncoras, tags personalizadas e blocos multilinha, podem não ser totalmente representados. Por isso, depois de converter, vale conferir o resultado, principalmente em arquivos de configuração grandes.
Conversores online enviam meus dados para servidor?
Alguns sim, outros não. Quando os dados são sensíveis (informações de clientes, chaves, configurações internas), prefira ferramentas que rodam no navegador. O conversor de dados do ValorFinal processa tudo localmente, sem enviar o conteúdo para nenhum servidor.
O que é CSV injection e por que isso importa na exportação?
CSV injection acontece quando uma célula que começa com =, +, - ou @ é interpretada como fórmula ao abrir o arquivo em um editor de planilhas, o que pode executar ações indesejadas. Por isso, uma exportação segura coloca um apóstrofo na frente dessas células, neutralizando a fórmula. Sempre confira a origem de planilhas antes de abrir.
Por que meu CEP perdeu o zero à esquerda na conversão?
Porque o conversor coagiu o campo para número, e números não guardam zeros à esquerda. CEP, CPF, CNPJ e códigos com zero inicial devem ser tratados como texto, não como número. Em um bom conversor, dá para indicar que esses campos permaneçam como string, preservando o zero. É um dos erros silenciosos mais comuns em conversão de dados.
Qual delimitador de CSV usar no Brasil?
Depende de como o arquivo foi gerado. O padrão internacional é a vírgula, mas planilhas configuradas em português brasileiro costumam exportar com ponto e vírgula, porque a vírgula é usada como separador decimal. Antes de converter, abra o CSV em um editor de texto para ver o delimitador real e selecione o correto no conversor.
Como acentos viram caracteres estranhos na conversão?
Quase sempre é problema de codificação. Se o arquivo de origem não está em UTF-8 (por exemplo, está em ISO-8859-1/Latin-1), acentos e cedilha podem aparecer corrompidos. A solução é padronizar a codificação em UTF-8 na origem e conferir uma amostra após converter. O problema costuma estar na codificação do arquivo, não na conversão em si.