Ao exportar JSON para CSV e abrir no Excel com configuração regional de Portugal ou do Brasil, números com ponto decimal como 3.14 costumam aparecer errados — porque nessas localidades a vírgula é o separador decimal, e o Excel passa a esperar ponto e vírgula (;) como separador de colunas em vez da vírgula.
Para que serve cada formato
- YAML — indentação em vez de chaves, padrão em pipelines de CI/CD, Kubernetes e Docker Compose.
- CSV — plano e tabular, o mínimo denominador comum para planilhas e ferramentas de análise.
- XML — mais antigo, com atributos e namespaces, ainda usado em serviços SOAP e sistemas corporativos legados.
- TOML — pensado para ser inequívoco e fácil de editar à mão, conhecido pelo
Cargo.tomldo Rust.
Por que o CSV pode "bagunçar" ao abrir no Excel em português
O Excel decide o separador de campos do CSV com base na configuração regional do sistema. Com a vírgula como separador decimal (padrão em Portugal e no Brasil), o Excel espera ponto e vírgula entre colunas, não vírgula. Um arquivo exportado com vírgulas pode aparecer como uma única coluna longa ao abrir com duplo clique — o seletor de delimitador deste conversor permite escolher ponto e vírgula para evitar isso.
A armadilha da tipagem automática no YAML
O parser de YAML tenta adivinhar o tipo de um valor sem aspas: version: 1.20 pode virar o número 1.2, perdendo o zero final, e o texto NO pode virar o booleano false segundo as regras do YAML 1.1, que tratavam yes/no como literais booleanos. Valores que precisam continuar sendo texto devem ser colocados entre aspas antes de converter para JSON.
Para que isso serve na prática
- Mover uma configuração de uma ferramenta que espera YAML para outra que espera JSON, ou o contrário.
- Exportar dados de uma API para CSV e revisar rapidamente numa planilha.
- Conectar um sistema legado baseado em XML/SOAP a uma API moderna baseada em JSON.