CSV a Markdown

¿Por qué convertir CSV a Markdown?

El CSV (Comma-Separated Values, valores separados por comas) es el formato de intercambio de datos más sencillo — texto con separadores, en uso desde los años 1970, legible por cualquier herramienta. Las tablas Markdown con pipes son el formato tabular más sencillo para wikis y prompts de IA — texto plano que se renderiza en cualquier motor Markdown.

Sin embargo, el traspaso directo no funciona: no puede pegar un archivo CSV en Obsidian, un post de Hugo o un prompt de Claude — aparecería como texto en bruto. Esta herramienta toma su CSV (o TSV, o PSV) y escribe GitHub Flavored Markdown limpio.

¿Cómo funciona la conversión?

Una biblioteca de hoja de cálculo open source consolidada lee los archivos CSV/TSV directamente en el navegador. Antes del análisis se ejecuta una heurística para detectar el separador: cuenta la frecuencia de comas, puntos y comas, tabulaciones y pipes en las primeras líneas — el candidato que produce el número de columnas más coherente gana. Esto cubre la configuración regional española (punto y coma), la anglosajona (coma), las exportaciones TSV y el PSV en un solo paso.

Tras el análisis se detecta la fila de encabezado (primera fila frente al resto) y la herramienta escribe una tabla GFM con pipes y línea separadora de encabezado (| --- |). Las celdas largas se ajustan si es necesario, las celdas vacías permanecen vacías (sin relleno «N/D»).

¿Para qué se utiliza realmente la herramienta?

• Lista de datos en documentación wiki. Un CSV con planes de suscripción, lista de proveedores o inventario se convierte en una tabla Markdown en la documentación interna.
• Prompt de IA con datos tabulares. Claude o GPT reciben los datos CSV como tabla con pipes directamente en el prompt — más preciso que el CSV en bruto.
• Tablas de contenido para Hugo / Astro. Las tablas estadísticas procedentes de exportaciones de base de datos llegan como bloques Markdown a los artículos del blog.
• Fuentes Dataview para Obsidian. Las tablas Markdown con encabezados claramente definidos pueden procesarse después en consultas Dataview.
• Tablas de issues en GitHub. Las exportaciones CSV de herramientas de seguimiento se convierten en tablas con pipes que siguen siendo legibles dentro del cuerpo de la issue.

¿Qué se conserva — qué se pierde?

Conservado: todos los valores de celdas (texto y números), la fila de encabezado (cuando se detecta o se define manualmente), el orden de las columnas, los caracteres especiales (mediante el quoting RFC 4180), los saltos de línea dentro de los campos (como <br> HTML en las tablas Markdown con pipes).

Añadido: la línea separadora de encabezado (| --- |) — Markdown la exige para que la tabla se renderice como tal.

Descartado a propósito: la información sobre el separador original (implícita en la sintaxis Markdown con pipes), los formatos de Excel (el CSV no los tiene — solo cadenas y números), los marcadores BOM de codificación (el Markdown es siempre UTF-8). La conversión es inequívoca: texto plano tabular se convierte en texto plano tabular, en otra sintaxis.

Privacidad — todo permanece en la pestaña del navegador

Los archivos CSV suelen contener datos muy sensibles: listas de suscriptores a newsletters, exportaciones de bases de clientes, datos de nóminas, KPI internos, listas de leads. Subir esos datos a un conversor en línea — incluso si promete «borrado en 24 horas» — infringe las normas internas de cumplimiento en prácticamente cualquier contexto sometido al RGPD.

Aquí no ocurre nada de eso. El CSV se lee y se convierte en la pestaña del navegador mediante estándares web (File API). Abra el panel Red de sus herramientas de desarrollador y compruebe: ningún registro abandona su equipo. El modo pegar también se ejecuta íntegramente del lado del cliente.

¿Qué conversores relacionados existen?

Esta herramienta forma parte de la familia de conversores Markdown:

• XLSX a Markdown — Excel incluidos XLS y ODS, con soporte multi-hoja.
• HTML a Markdown — modo archivo o pegado.
• PDF a Markdown — también PDF escaneados vía OCR.
• DOCX a Markdown — documentos Word con estructura de títulos y listas preservadas.