CSV: separador, acentos UTF-8 e como imprimir em PDF legível
Como um CSV separa as colunas, por que os acentos saem trocados e como salvar em UTF-8 e converter para PDF sem colunas cortadas. Tabela de separadores incluída.
CSV é um arquivo de texto puro em que cada linha é uma linha da tabela e os valores são separados por vírgula, ponto e vírgula ou tabulação. Ele não guarda fórmulas, cores ou configuração de página. Para virar PDF, o conversor de Excel aceita o CSV e o trata como uma planilha de uma aba só, com o separador detectado na primeira linha.
Como um CSV é escrito por dentro
Um CSV é só texto. A primeira linha costuma ser o cabeçalho, com o nome de cada coluna, e cada linha seguinte é um registro. Um texto que contém o próprio separador, como um endereço com vírgula, fica entre aspas para não quebrar a coluna. Um editor de texto comum abre o arquivo e mostra exatamente o que está gravado, o que é útil para conferir um problema.
Como não há formatação, o CSV é o formato mais leve para trocar dados entre sistemas. Bancos, sistemas de gestão e ferramentas de cadastro costumam exportar relatórios assim. A contrapartida é que nada do que você vê numa planilha acompanha o arquivo.
O separador: por que muda de país para país
O separador padrão do CSV original é a vírgula, mas no Brasil o Excel usa o ponto e vírgula quando salva em português. A razão é o separador decimal: em português, a vírgula separa a parte decimal do número, como em 1.240,50. Para não confundir os dois usos, o programa escolhe o ponto e vírgula como separador de colunas.
Por isso um mesmo relatório pode chegar com vírgulas de um sistema e com ponto e vírgula de outro. O conversor resolve a diferença sozinho, olhando a primeira linha. A regra é simples: o caractere que aparece mais vezes na linha de cabeçalho é o separador. Para o caminho inverso, uma tabela de PDF virando CSV com o separador que o Excel em português espera, veja PDF para CSV: tabela sem bordas e separador.
| Separador | Onde é comum | Exemplo de linha |
|---|---|---|
| Vírgula | Exportações em inglês e sistemas internacionais | nome,valor,data |
| Ponto e vírgula | Excel e sistemas em português do Brasil | nome;valor;data |
| Tabulação | Cópias de tabelas e alguns exportadores | nome valor data, separados por tab |
Acentos e UTF-8
O maior problema do CSV no Brasil não é o separador, é a codificação. A codificação é a tabela que diz qual número representa cada letra. O padrão atual, o UTF-8, representa “ã” e “ç” sem ambiguidade. O padrão antigo do Windows em português usa outra tabela, e um arquivo salvo nela, aberto como UTF-8, mostra os acentos trocados.
O conversor do AjustaPDF lê o CSV como UTF-8. Se o seu arquivo veio com acentos estranhos, a correção está na origem: abra no Excel e use Salvar como, escolhendo a opção de CSV em UTF-8 (delimitado por vírgulas). Em versões recentes, a opção aparece com esse nome na lista de formatos. Um arquivo TXT tem o mesmo problema de codificação, tratado em arquivo TXT e os acentos que saem errados. Depois, converta a cópia nova. Quem gera o CSV por código em Python resolve os acentos gravando com utf-8-sig, como no guia extrair tabelas de PDF com Python.
Como imprimir um CSV em PDF que dá para ler
O CSV não tem área de impressão nem orientação, porque esses dados não existem no arquivo. Na conversão, a escolha que mais importa é o layout. Com “Como a planilha está configurada para imprimir”, como não há configuração salva, o conversor usa o padrão do programa, e uma tabela com muitas colunas pode sair cortada em várias folhas. Com “Cada aba inteira numa página só”, a tabela inteira cabe numa única página, do tamanho dela.
Para uma lista de nomes e valores, a página única é quase sempre a melhor escolha. Para um relatório longo, com centenas de linhas, ela fica muito alta, e a opção de configuração da planilha pode ser melhor depois de você abrir o CSV no Excel e ajustar a página. Teste as duas antes de mandar para a impressora.
O que o CSV não mostra
Uma fórmula no Excel vira o valor que estava na célula quando o arquivo foi salvo como CSV. Um número formatado como moeda vira só o número, sem o R$. Cor, negrito e o tamanho das colunas também se perdem. Se você precisa de um PDF com cara de relatório, converta a planilha original em XLSX, não o CSV.
Esse é um motivo para guardar a planilha de origem. Quando o CSV é uma exportação de sistema, ele é o dado puro, e a formatação precisa ser refeita. Quando você mesmo criou a tabela no Excel, o XLSX preserva tudo, e o CSV é só uma cópia de transporte.
Quando o CSV é a melhor escolha
O CSV é a melhor escolha quando você precisa mover dados entre programas sem nenhuma formatação, ou quando o sistema de origem só exporta nesse formato. Para entregar o conteúdo de uma tabela como documento, o PDF é mais adequado, porque mantém a leitura e a impressão sem depender de ninguém ter a planilha instalada.
Para comparar com outros formatos de planilha, veja o guia sobre o arquivo XLSX, que explica o corte de colunas, e o guia sobre o arquivo ODS, da planilha do LibreOffice. A conversão de tabelas está na página de Excel para PDF, que aceita CSV junto com as planilhas.
Para converter um CSV agora, veja converter CSV em PDF. A escolha entre os dois formatos de tabela está em CSV ou XLSX.
Perguntas frequentes
Por que o meu CSV abre com os acentos trocados, tipo “São Paulo”?
Porque o arquivo foi salvo numa codificação diferente da que o programa espera. O conversor lê o CSV como UTF-8. Se o arquivo foi salvo no padrão antigo do Windows, os acentos viram letras estranhas. Salve de novo como “CSV UTF-8” no Excel e converta a cópia nova.
Vírgula ou ponto e vírgula: qual separador o conversor entende?
Os dois. O conversor olha a primeira linha do arquivo e escolhe o separador que aparece mais: ponto e vírgula, vírgula ou tabulação. Por isso, um CSV com ponto e vírgula vindo do Excel em português abre em colunas sem você precisar configurar nada.
Como imprimir um CSV em PDF sem que as colunas sejam cortadas?
Escolha a opção “Cada aba inteira numa página só” na conversão. Um CSV não tem configuração de página, e a planilha padrão do programa de conversão costuma cortar tabelas largas. Com a página única, a tabela inteira fica numa folha do tamanho dela.
O CSV guarda fórmulas e cores da planilha?
Não. O CSV guarda só o texto de cada célula e o separador entre elas. Fórmulas são substituídas pelo valor que aparecia, e cores, negrito, larguras de coluna e gráficos são perdidos. Se a formatação importa, converta a planilha original em PDF, e não o CSV.