CSV parece simples até um valor conter o delimitador. Separar cada linha por vírgulas funciona com Alice,Active,10, mas falha com "Keyboard, compact" ou "1,999.00". Uma conversão confiável precisa analisar o registro CSV primeiro e gerar Markdown depois.
Comece com registros CSV válidos
Um analisador CSV trata separadores dentro de campos entre aspas como texto. Uma aspa dentro desse campo é representada por duas aspas:
Product,Description,Price
Keyboard,"Compact, wireless","$89.00"
Monitor,"27"" IPS display","$299.00"O segundo registro tem três células, não cinco. Antes de converter um arquivo grande, confirme delimitador e codificação. Planilhas podem exportar vírgulas, tabulações ou ponto e vírgula conforme a região. O DevToy detecta vírgulas e tabulações; prefira TSV quando houver muitas vírgulas nos campos.
Converta a grade analisada em Markdown
Uma tabela Markdown precisa de cabeçalho e linha separadora:
| Product | Description | Price |
| :--- | :--- | ---: |
| Keyboard | Compact, wireless | $89.00 |
| Monitor | 27" IPS display | $299.00 |Alinhe textos e identificadores à esquerda, estados curtos ao centro e números comparáveis à direita. Alinhamento é apenas apresentação; não transforma texto em número.
Escape caracteres específicos do Markdown
Aspas CSV e escapes Markdown resolvem problemas diferentes. Uma barra vertical literal deve virar \| antes da geração, ou iniciará outra coluna. A maioria dos renderizadores não aceita quebra de linha literal na célula. Troque por espaço ou use <br> apenas quando o destino permitir HTML.
Não remova aspas indiscriminadamente. O analisador retira somente as que delimitam o campo e converte aspas duplicadas em uma aspa literal.
Valide no destino
GitHub, GitLab e geradores de documentação usam dialetos diferentes. Teste uma amostra na plataforma final e confira colunas, barras, HTML e Unicode antes de processar milhares de linhas.
Para dados sensíveis, use o gerador visual de tabelas Markdown. A análise e a conversão rodam no navegador, sem enviar conteúdo a uma API.