CSV a Markdown

¿Por qué convertir CSV a Markdown?

El CSV (Comma-Separated Values) es texto con separador, un formato de intercambio en uso desde los años 70. En una nota, una wiki o una indicación quieres las mismas filas como tabla que se pueda leer.

GitHub Flavored Markdown escribe esa tabla con barras verticales. Un motor la muestra como tabla si admite tablas. Si no, la línea sigue siendo texto.

¿Cómo funciona la conversión?

Sueltas un archivo CSV, TSV o TAB, o pegas el texto. Cuenta un archivo por pasada. La conversión empieza cuando pulsas Convertir a Markdown.

Coma, punto y coma y tabulador son los separadores habituales que se han probado. No los eliges tú. La primera fila conservada pasa a ser el encabezado. Si falta, ponla antes. Si no, los primeros valores de datos pasan a ser los títulos.

Las celdas vacías siguen vacías. Las filas del todo vacías se saltan. Las filas más cortas se rellenan con celdas vacías hasta la fila más ancha. Un salto de línea dentro de una celda pasa a <br>, y esa fila de la tabla sigue siendo una línea en el código. Una barra vertical dentro de una celda se escapa para que no corte la columna. Las celdas largas no se parten solas.

00123 puede pasar a 123, también si el campo va entre comillas. No está asegurado que el texto original salga igual. Revisa identificadores y números en el resultado.

Al leer, un campo entre comillas puede contener el separador, un salto de línea o unas comillas dobladas. Un nombre entre comillas conserva la coma en la misma celda. Lo escrito es Markdown.

El archivo se lee como UTF-8. Windows-1252, ISO-8859-1 y UTF-16 no se reconocen. Los archivos antiguos los guardas antes como UTF-8. El selector admite hasta 50 MB. El texto pegado no tiene aquí un límite de bytes propio.

El encabezado YAML lo activas si lo quieres. Viene activado. Después ves el código Markdown en un bloque. Lo copias o descargas un archivo .md.

¿Para qué se utiliza realmente la herramienta?

• Lista de datos en la documentación de la wiki. Un CSV de planes, proveedores o inventario pasa a tabla Markdown en la documentación interna.
• Indicación con datos de tabla. Los valores quedan en la indicación como tabla Markdown.
• Tablas de contenido para Hugo / Astro. Las tablas estadísticas de una exportación quedan como bloque Markdown en las entradas.
• Notas en Markdown. La tabla queda como texto en la nota y se puede leer la próxima vez que la abras.
• Tablas en incidencias de GitHub. Las exportaciones de herramientas de seguimiento quedan como tablas legibles en la descripción.

¿Qué se conserva: qué se pierde?

Sigue ahí: el orden de las columnas, el texto de las celdas, las celdas vacías, los saltos de línea como <br>.

Siempre puesto: la primera fila conservada como encabezado, y debajo | --- |. La línea se muestra como tabla si el motor admite tablas.

Puede cambiar: el texto numérico. 00123 puede pasar a 123, también entre comillas. Los ceros a la izquierda no se conservan de forma fiable.

Privacidad: todo permanece en la pestaña del navegador

Las exportaciones CSV pueden ser delicadas: listas de distribución, clientes, nóminas. El archivo o el texto pegado se lee en local en el navegador y no se sube para la conversión. Nada de eso se guarda para ello en un servidor ajeno.

¿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.