O que esta ferramenta faz
Aplica a regra de campo da RFC 4180, que é condicional e não sistemática. O campo é envolvido em aspas duplas apenas se contiver um destes:
- o delimitador que você escolheu (
,por padrão, ou;, tabulação,|); - uma aspa dupla — que é então duplicada dentro do campo;
- um retorno de carro ou uma quebra de linha.
Caso contrário, o texto volta intacto. Não é a ferramenta deixando de fazer algo: um valor sem caractere especial já é um campo CSV válido, e envolvê-lo assim mesmo acrescentaria um ruído que alguns analisadores carregam até o valor importado.
Quando você precisa dela
Ao montar uma linha CSV à mão, ou ao descobrir por que uma planilha dividiu um valor em duas colunas. O culpado de sempre é uma vírgula dentro de um endereço ou de um nome de produto — cole aqui e a forma corretamente entre aspas volta.
O que ela não faz
Ela escapa um campo, não uma linha inteira nem um arquivo. Quebras de linha dentro de um campo entre aspas são CSV legal e são preservadas como estão; cabe ao analisador que lê o arquivo entendê-las como parte do valor e não como um novo registro.
Privado por padrão
Tudo é executado localmente no seu navegador com JavaScript. Os seus dados nunca são enviados para um servidor, o que torna a ferramenta segura para conteúdo sensível e funciona offline.