Convertir CSV a tabla Markdown
Escribir a mano una tabla Markdown obliga a contar barras y guiones en cada línea. Suba el CSV y obtenga una tabla con fila de encabezado y fila separadora, lista para pegar en un README, una página de wiki o un cuaderno.
Convertidor de datos
o suelte aquí archivos CSV, TSV, TXT … ·
Máx. 95 MB por archivo· Hasta 20 archivos· Se borran a los 30 minutos
Los archivos se procesan en nuestros servidores y se borran a los 30 minutos.
Carácter que separa las columnas en archivos CSV y de texto, tanto al leer como al escribir. Automático lo detecta en la entrada y escribe comas.
UTF-8 funciona con cualquier idioma. Elija UTF-8 con BOM si Excel en Windows muestra tildes o caracteres asiáticos ilegibles al abrir el CSV.
Entrada de Excel, ODS y Numbers: convierte solo la primera hoja o todas (un CSV por hoja dentro de un ZIP, o una clave JSON por hoja).
Nombre de la pestaña de la hoja en la nueva hoja de cálculo, de hasta 31 caracteres.
Array de objetos usa los nombres de columna como claves en cada fila; array de arrays es más compacto y conserva el encabezado como primer array.
Nombre del elemento exterior que envuelve todas las filas; cada fila se convierte en un <row> dentro de él.
Se usa en las sentencias CREATE TABLE e INSERT. Solo letras, dígitos y guiones bajos.
Las comillas y los tipos de columna varían un poco entre bases de datos; elija aquella en la que va a importar.
Reescribe las celdas de fecha en un solo formato. ISO (2026-10-18) es el más seguro para bases de datos y código; Mantener sin cambios las deja como aparecen en el original.
Cómo usar esta herramienta
- 1
Suba el CSV
Agregue archivos .csv, .tsv o .txt delimitados, hasta 20 a la vez y de 95 MB cada uno. La detección automática reconoce comas, puntos y coma, tabulaciones y barras verticales.
- 2
Confirme el encabezado
La primera fila es el encabezado está activada, así que la fila 1 se convierte en el encabezado de la tabla. Desactívela en Opciones avanzadas si su archivo empieza directamente con datos.
- 3
Convierta y pegue
Pulse Convertir a Tabla Markdown, abra el archivo .md y pegue la tabla en su README, pull request, issue o nota.
¿Cómo convierto un archivo CSV en una tabla Markdown?
Suba el CSV y pulse Convertir a Tabla Markdown. La primera fila pasa a ser el encabezado de la tabla, debajo se agrega una fila de guiones y cada una de las demás líneas se convierte en una fila con las celdas separadas por barras verticales.
Por qué los desarrolladores convierten CSV a Markdown
La documentación acaba una y otra vez en archivos Markdown. Una persona que mantiene un proyecto quiere una tabla de versiones compatibles en el README, un ingeniero pega cifras de rendimiento en un pull request, una investigadora lleva su lista de lecturas en Obsidian. Los números suelen salir de una hoja de cálculo o del CSV que genera un script, y reconstruirlos a mano, con una barra entre cada celda, es lento y propenso a errores.
El Markdown original de John Gruber, de 2004, no tenía tablas. La sintaxis con barras se difundió a través de PHP Markdown Extra y quedó recogida en la especificación GitHub Flavored Markdown en 2017, y por eso funciona en GitHub y en la mayoría de las herramientas que la siguen. Si las filas vienen de Excel, guárdelas primero con Excel a CSV y luego conviértalas aquí.
Ejemplo de CSV convertido a tabla Markdown
entorno,versión,estado Python,3.13,compatible Python,3.9,sin soporte | octubre 2025 Node.js,22,compatible
| entorno | versión | estado | | --- | --- | --- | | Python | 3.13 | compatible | | Python | 3.9 | sin soporte \| octubre 2025 | | Node.js | 22 | compatible |
Dónde se muestra una tabla Markdown convertida
| Organismo | Requisito | Fuente |
|---|---|---|
| GitHub | Muestra tablas con barras en README, issues, pull requests y wikis, según la especificación GFM. | Especificación GFM |
| GitLab | GitLab Flavored Markdown muestra las mismas tablas con barras en repositorios, issues y merge requests. | — |
| Obsidian | Muestra las tablas con barras en el modo lectura y permite editarlas en la vista previa en vivo. | — |
| Jupyter | Las celdas Markdown de los cuadernos muestran tablas con barras junto al código. | — |
| CommonMark | La especificación base no tiene sintaxis de tablas; los intérpretes necesitan una extensión de tablas. | Sitio oficial de CommonMark |
Datos sobre los formatos CSV y Markdown
CSV
Valores separados por comas (CSV)
CSV es un formato de texto plano para tablas en el que cada línea es una fila y las comas separan las columnas. Se usa desde los primeros tiempos de la informática y se describe en el RFC 4180, aunque muchas variantes usan punto y coma o tabulaciones y distintas codificaciones de texto. Casi todas las hojas de cálculo, bases de datos y herramientas de análisis pueden importarlo y exportarlo, lo que lo convierte en el formato predeterminado para mover datos entre sistemas. CSV guarda solo valores, sin fórmulas, formato, varias hojas ni tipos de datos.
- Compresión
- –
- Transparencia
- –
- Animación
- –
- Presentado en
- –
MD
Markdown
Markdown es una sintaxis de marcado ligera creada por John Gruber en 2004. Usa símbolos de texto plano, como # para los encabezados, * para el énfasis y - para las listas, que siguen siendo legibles como texto sin formato y se convierten limpiamente a HTML. Es el estándar para archivos README, documentación, wikis, aplicaciones de notas y muchos generadores de sitios estáticos. Existen varios dialectos, como CommonMark y GitHub Flavored Markdown, que difieren en detalles como las tablas. Cualquier editor de texto puede abrir archivos .md.
- Compresión
- –
- Transparencia
- –
- Animación
- –
- Presentado en
- 2004 · John Gruber
Un CSV se convierte en Markdown cuando un conjunto de datos pequeño tiene que vivir dentro de la documentación: la tabla de compatibilidad de un README, la lista de versiones de un registro de cambios, un pull request que compara pruebas de rendimiento o una nota en una base de conocimiento personal.
La conversión conserva casi intactos los valores, pero no la intención. Un CSV guarda cada fila para que la lea un programa; una tabla Markdown es una imagen de los datos para personas, sin tipos, sin fórmulas y sin forma de combinar celdas. Mantenga el CSV en el repositorio como fuente y vuelva a generar la tabla cuando cambien las cifras.
Preguntas frecuentes sobre CSV a Markdown
¿Dónde se muestran bien las tablas Markdown creadas desde un CSV?
Allí donde el intérprete admita la extensión de tablas con barras: GitHub, GitLab, Obsidian, cuadernos de Jupyter y generadores de sitios estáticos como MkDocs y Hugo. Un intérprete estrictamente CommonMark muestra esas mismas líneas como texto plano, con las barras visibles.
¿Qué pasa si un valor de mi CSV contiene una barra vertical?
Una | sin escapar abriría una celda nueva y desplazaría todas las columnas a la derecha. El convertidor la escribe como \|, el escape que define GitHub Flavored Markdown, de modo que la barra aparece como texto dentro de la celda.
¿Puedo alinear los números a la derecha en la tabla Markdown?
Sí, editando la fila separadora: ---: alinea una columna a la derecha, :---: la centra y :--- la alinea a la izquierda. Agregue los dos puntos después de convertir; solo cambian cómo se muestra la tabla, no los datos.
¿Qué tamaño de CSV tiene sentido como tabla Markdown?
Las tablas Markdown están pensadas para leerse, así que funcionan mejor con unas pocas decenas de filas y un puñado de columnas. Una tabla de miles de filas se convierte sin problema, pero hace difícil desplazarse por un README; en ese caso, enlace el archivo CSV del repositorio y muestre una muestra.
¿Qué ocurre con los saltos de línea dentro de un campo CSV?
Una fila de tabla Markdown debe ocupar una sola línea, así que un valor CSV entre comillas que abarca varias líneas no puede conservarse tal cual. Sustituya esos saltos antes de convertir; en GitHub puede usar <br> dentro de una celda para forzar uno.
¿Puedo convertir el CSV a una tabla HTML en lugar de Markdown?
Si el destino es una página web, un CMS o un correo y no un archivo Markdown, ponga Convertir a en Tabla HTML. Para datos que empiezan como JSON, la página JSON a HTML tiene esa salida ya seleccionada.