IA en tu dispositivo: profesional y privado.

Documentos

CSV a tabla Markdown: cómo convertir un CSV para GitHub, README y documentación

Convierte un CSV en una tabla Markdown para GitHub, un README o tu documentación: alineación por columna, barras verticales y saltos de línea seguros, y límites de tamaño.

Actualizado el 8 de noviembre de 202610 min de lectura

Para convertir un CSV en una tabla Markdown, suelta el archivo en un convertidor de CSV a Markdown, revisa la vista previa renderizada, ajusta la alineación de cada columna y copia el resultado en tu README, tu issue o tu página de documentación. El convertidor escribe las tres partes que necesita toda tabla Markdown: una fila de cabecera, una fila separadora de guiones y una línea por registro. Lo difícil no es la forma, sino las celdas: una barra vertical, un salto de línea dentro de un campo entre comillas o un asterisco suelto pueden partir una fila, desplazar datos a la columna equivocada o poner texto en cursiva. Esta guía cubre los pasos, la alineación, esos caracteres problemáticos y los límites de tamaño que importan antes de pegar.

Cómo convertir un CSV en una tabla Markdown

1

Añade el CSV

Abre el convertidor de CSV a Markdown y suelta un archivo .csv, .tsv, .txt o .psv. El delimitador, el carácter de comillas y la codificación se detectan a partir del propio archivo, y la herramienta te indica qué ha elegido.

2

Revisa la fila de cabecera

Deja activada Primera fila como cabecera cuando la fila uno contenga los nombres de las columnas. Desactívala si el archivo empieza directamente con datos; la tabla recibe entonces etiquetas generadas Col 1, Col 2.

3

Ajusta la alineación

Elige una Alineación por defecto para toda la tabla y luego cambia cualquier columna concreta desde el desplegable de su cabecera en la vista previa. Los números suelen leerse mejor alineados a la derecha.

4

Revisa la vista previa de las dos formas

Cambia entre Renderizada y Markdown. La vista renderizada muestra si una celda con un asterisco o un salto de línea se comporta bien; la vista en bruto muestra exactamente lo que vas a pegar.

5

Copia o descarga

Pulsa Convertir a Markdown y después Copiar Markdown para un README o un pull request, o Descargar .md con el nombre de archivo que escribiste en Descargar como.

De qué está hecha una tabla Markdown

Una tabla Markdown en el dialecto GitHub-Flavored es texto plano. La primera línea es la cabecera, con las celdas separadas por barras verticales. La segunda línea es el separador: guiones bajo cada columna, y su presencia es lo que convierte el bloque en una tabla. Cada línea siguiente es un registro. GitHub, GitLab, Obsidian, VS Code y la mayoría de los generadores de sitios estáticos leen este mismo formato, así que una tabla convertida funciona en todos ellos.

El formato tiene límites estrictos que conviene conocer antes de empezar. No hay forma de combinar celdas entre filas o columnas, cada fila debe ocupar una sola línea y la cabecera siempre se muestra en negrita. Si una fila del CSV tiene menos celdas que la cabecera, el convertidor la completa con celdas vacías; si tiene más, la tabla se ensancha hasta la fila más ancha, de modo que nada se recorta sin avisar.

Alineación de columnas en una tabla Markdown

La alineación vive solo en la fila separadora, en forma de dos puntos junto a los guiones. El convertidor los escribe por ti, y puede escribir uno distinto para cada columna:

AlineaciónSeparador escritoIdeal para
Izquierda:---Nombres, etiquetas, texto libre
Centro:---:Columnas de estado cortas, sí/no, marcas de un carácter
Derecha---:Precios, cantidades, porcentajes
Ninguna---Dejarlo al visor (izquierda casi en todas partes)

El caso habitual es una tabla que mezcla el nombre de un producto con un precio y unas existencias: pon Izquierda como valor por defecto y cambia las dos columnas numéricas a Derecha en sus cabeceras de la vista previa. Las cifras alineadas a la derecha coinciden en su último dígito, y eso es lo que permite comparar una columna de números a simple vista. Ten en cuenta que algunas aplicaciones ignoran los dos puntos; Notion, por ejemplo, convierte una tabla Markdown pegada en su propia tabla y descarta la alineación.

Alineación por columna, escape seguro de barras verticales y saltos de línea, salida con relleno o compacta, copia o descarga en .md. Gratis: un CSV de hasta 25 MB, sin límite de filas y con todas las opciones de formato. Pro: hasta 50 archivos a la vez en un ZIP o en un único documento combinado. Todo se procesa en tu dispositivo, no en nuestros servidores.

Convertir CSV a Markdown

Barras verticales, saltos de línea y caracteres que rompen una tabla

El texto de una hoja de cálculo no sabe que está a punto de convertirse en Markdown. Estos son los caracteres que dan problemas y lo que el convertidor hace con cada uno:

En una celdaQué falla sin escaparQué hace el convertidor
Una barra vertical |Cierra la celda antes de tiempo; la fila gana una columna y los datos se desplazanSiempre se escapa como \|
Una barra invertidaPuede tragarse el carácter que la sigueSiempre se duplica, así que una ruta de Windows sobrevive
Un salto de línea en un campo entre comillasLa fila termina a mitad de celda y el resto de la tabla se desmoronaSe convierte en <br> por defecto, o en un \n literal, o en un espacio
Asteriscos, guiones bajos, comillas invertidasEl texto pasa a negrita, cursiva o códigoSe escapan solo con Escapar caracteres Markdown activado
Corchetes, signos de menor/mayor, virgulillasPueden convertirse en enlaces, HTML o tachadoSe escapan con el mismo interruptor
Guiones, puntos, signos másNada, dentro de una celda de tablaSe dejan como están, para que fechas y precios sigan legibles

El ajuste para los saltos de línea es Saltos de línea en una celda. Mantén <br> para GitHub y GitLab, donde se muestra como un salto real y una dirección postal sigue siendo una sola celda legible. Elige \n literal cuando la tabla vaya a un sitio que elimina el HTML y aun así quieras ver que ahí había un salto. Elige Espacio cuando los saltos fueron un accidente de la exportación, como el texto ajustado en una columna de la hoja de cálculo.

Deja Escapar caracteres Markdown desactivado salvo que la vista previa muestre un problema. La mayoría de las tablas no contienen ninguno de estos caracteres, y con el interruptor activado cada uno recibe una barra invertida visible en el archivo en bruto. Una celda con un valor como _borrador_ o una palabra entre asteriscos es justo el caso en que sí lo necesitas: sin escapar, se muestra en cursiva y las marcas desaparecen.

Primero, que el CSV se lea bien

Muchas tablas rotas ya lo están antes de escribir una sola línea de Markdown, porque el CSV se dividió por el carácter equivocado. El convertidor prueba coma, punto y coma, tabulador y barra vertical sobre una muestra, se queda con el que da anchos de fila más coherentes y te avisa si la lectura parece dudosa. Las exportaciones europeas suelen usar punto y coma; si la vista previa lo muestra todo en una sola columna, fija el Delimitador a mano.

  • Codificación: si los nombres con tildes salen como caracteres extraños, probablemente el archivo es Windows-1252 y no UTF-8. Fíjala a mano; un archivo que lleva marca de orden de bytes (BOM) siempre manda, y la marca invisible que añade la exportación CSV UTF-8 de Excel se elimina para que no se pegue a tu primer encabezado.
  • Omitir filas iniciales: las exportaciones de informes suelen llevar un título y una fecha encima de la cabecera real. Omítelas para que la fila uno sea la cabecera.
  • Eliminar filas vacías y Eliminar columnas vacías: las exportaciones de hojas de cálculo acumulan filas en blanco al final y columnas sin usar a un lado. Cada una se convertiría en celdas vacías en tu tabla.
  • Limitar filas: un README necesita las primeras 20 filas de una exportación grande, no todas. 0 conserva todas las filas.

Si la tabla necesita menos columnas de las que tiene el CSV, quítalas antes con Añadir o quitar columnas CSV, y consulta cómo eliminar columnas de un CSV para los detalles. Una tabla con cuatro columnas bien elegidas se lee mucho mejor que una con doce.

Límites de tamaño: el convertidor y el sitio donde pegas

En el plan gratuito, el convertidor acepta un archivo de hasta 25 MB, sin límite de filas. El sitio mide que una exportación de 25 MB con unas 225.000 filas se convierte en alrededor de un segundo en un ordenador de escritorio. La vista previa muestra solo las primeras filas y columnas para que la página siga ágil, pero la descarga y el texto copiado las contienen todas. Pro convierte hasta 50 archivos a la vez, ya sea en un ZIP o combinados en un único documento Markdown con cada tabla bajo un encabezado tomado de su nombre de archivo.

El límite más estricto suele ser el destino, no el convertidor:

DestinoLímite prácticoQué hacer
Issue, pull request o comentario de GitHubEl cuerpo tiene un máximo de 65.536 caracteresUsa Limitar filas, o sube la tabla como archivo .md
README o archivo de documentación en un repositorioSin un tope pequeño, pero una tabla muy larga cuesta de leerMuestra una parte y enlaza el CSV completo
Cualquier página leída en un móvilLas tablas anchas se desplazan en horizontalQuédate en unas 4 a 6 columnas
Texto en bruto en un editorEl relleno hace cada línea tan ancha como el valor más anchoUsa la salida compacta con celdas de texto largas

Recuerda que el Markdown ocupa más que el CSV del que sale: cada celda gana barras y espacios, y el relleno añade más. Una exportación completa rara vez cabe bien en un documento. Veinte filas bien elegidas con un enlace al archivo original es lo que quiere la mayoría de los lectores.

Otras opciones que conviene conocer

  • Numerar las filas añade una columna de numeración, útil cuando los revisores necesitan decir «la fila 14 está mal» en un comentario.
  • Primera fila de datos en negrita y Primera columna en negrita se aplican solo al cuerpo, porque la cabecera ya se muestra en negrita.
  • Carácter de comillas puede ser comilla doble, apóstrofo o ninguno; una comilla solo abre un campo al principio, así que el apóstrofo de O'Brien sigue siendo texto.

Cuándo una tabla Markdown no es la opción adecuada

Las tablas Markdown sirven para datos pequeños y legibles dentro de un texto. Si alguien necesita ordenar, filtrar o calcular, dale los datos como hoja de cálculo con CSV a Excel. Si los va a leer un programa, CSV a JSON es mejor formato. Si solo necesitas revisar un archivo grande antes de elegir filas, ábrelo primero en el visor de CSV.

Si tu tabla está en un documento de Word y no en un CSV, el trabajo es distinto: los encabezados, las listas y el formato vienen con ella. Eso se explica en convertir Word a Markdown, con la herramienta Word a Markdown.

Preguntas frecuentes

¿Cómo convierto un CSV en una tabla Markdown?

Suelta el CSV en el convertidor de CSV a Markdown, deja activada Primera fila como cabecera si la fila uno tiene los nombres de las columnas, ajusta la alineación, pulsa Convertir a Markdown y copia el resultado o descárgalo como archivo .md. La fila de cabecera, la fila separadora y el escape se escriben por ti.

¿Cómo alineo una columna a la derecha en una tabla Markdown?

Pon dos puntos al final derecho del separador de esa columna, escrito ---:. En el convertidor se ajusta desde el desplegable de la cabecera de la columna en la vista previa, así que las columnas numéricas pueden ir a la derecha mientras el texto se queda a la izquierda.

¿Cómo pongo una barra vertical dentro de una celda de tabla Markdown?

Escápala como \| para que no se lea como el final de la celda. El convertidor lo hace automáticamente con todas las barras verticales, también con las que están dentro de texto que parece código.

¿Puede una celda de tabla Markdown contener un salto de línea?

No directamente: cada fila debe ser una sola línea. En GitHub y GitLab, un <br> dentro de la celda se muestra como salto de línea, y es lo que el convertidor usa por defecto para los campos CSV de varias líneas. También puedes elegir un \n literal o un simple espacio.

¿Por qué todo mi CSV aparece en una sola columna?

El archivo usa un delimitador distinto del que se está aplicando, casi siempre punto y coma en exportaciones de versiones europeas de Excel. Fija el Delimitador a mano en Punto y coma, Tabulación o Barra vertical y las columnas se separan.

¿Hay un límite de tamaño para convertir CSV a Markdown?

El plan gratuito convierte un archivo de hasta 25 MB, sin límite de filas y con todas las opciones de formato. Pro admite hasta 50 archivos a la vez. El límite más habitual es el destino: GitHub limita el cuerpo de un issue o pull request a 65.536 caracteres, así que usa Limitar filas para las tablas que pegues ahí.

Sigue leyendo

Más sobre Documentos →