CSV parece sencillo hasta que un valor contiene el delimitador. Dividir cada línea por comas funciona con Alice,Active,10, pero falla con valores como "Keyboard, compact" o "1,999.00". Una conversión fiable debe analizar primero el registro CSV y generar Markdown después.
Empieza con registros CSV válidos
Un analizador CSV trata los separadores dentro de campos entrecomillados como texto. Una comilla dentro de uno de esos campos se representa con dos comillas:
Product,Description,Price
Keyboard,"Compact, wireless","$89.00"
Monitor,"27"" IPS display","$299.00"El segundo registro tiene tres celdas, no cinco. Antes de convertir un archivo grande, confirma el delimitador y la codificación. Según la configuración regional, una hoja de cálculo puede exportar comas, tabulaciones o punto y coma. DevToy detecta entradas separadas por comas y tabulaciones; usa TSV cuando los campos contienen muchas comas.
Convierte la cuadrícula analizada a Markdown
Una tabla Markdown necesita una fila de encabezado y otra de separación:
| Product | Description | Price |
| :--- | :--- | ---: |
| Keyboard | Compact, wireless | $89.00 |
| Monitor | 27" IPS display | $299.00 |Alinea a la izquierda texto e identificadores, centra estados breves y alinea a la derecha números comparables. La alineación solo controla la presentación; no convierte una cadena en un número.
Escapa los caracteres propios de Markdown
Las comillas CSV y los escapes Markdown resuelven problemas distintos. Una barra vertical literal debe convertirse en \| antes de generar Markdown o creará una nueva columna. La mayoría de renderizadores tampoco admite saltos de línea literales dentro de una celda. Sustitúyelos por un espacio o usa <br> solo si el destino permite HTML.
No elimines todas las comillas indiscriminadamente. El analizador solo retira las que delimitan el campo y convierte las comillas dobles escapadas en una comilla literal.
Valida en el destino
GitHub, GitLab, los generadores de documentación y las aplicaciones de notas usan dialectos Markdown distintos. Prueba una muestra pequeña en la plataforma final y comprueba columnas, barras verticales, HTML y Unicode antes de procesar miles de filas.
Para datos sensibles, usa el generador visual de tablas Markdown. El análisis y la conversión se ejecutan en el navegador, sin enviar el contenido a una API.