De CSV a tabla Markdown

Cómo funciona

La primera fila se toma como encabezado de la tabla; justo debajo se añade la fila de alineación propia de Markdown, y las filas restantes pasan a ser los datos. Con la detección automática, los candidatos punto y coma, coma, tabulador y barra vertical se cuentan fuera de las comillas, y se elige el que produce el mismo número de columnas en cada fila — así la coma dentro de un campo de dirección no se confunde con un separador. También se leen los tres finales de línea: el CR+LF de Windows, el LF de macOS y Linux y el CR solitario de los programas más antiguos, que muchas herramientas toman por una única línea larga. La barra vertical que aparezca en una celda se escapa con una barra invertida, porque en Markdown ese carácter corta la columna. El salto de línea de una celda multilínea entre comillas se sustituye por una etiqueta <br>: en una tabla Markdown, cada celda debe caber en una sola línea. Las celdas de la salida se rellenan con espacios según el ancho de cada columna, de modo que la tabla se lee bien incluso como texto plano, antes de cualquier renderizado.

Esta herramienta también se busca como csv a markdown, csv to markdown, tabla markdown online, markdown table generator, tabla para readme.

¿Qué es Markdown?

Markdown es un lenguaje de escritura ligero que expresa el formato con signos de puntuación en lugar de etiquetas: una almohadilla al inicio de línea hace un título, un texto entre asteriscos sale en negrita, una línea que empieza con guion se vuelve un elemento de lista. Como el archivo fuente se puede leer incluso sin renderizar, se ha convertido en el estándar de los repositorios de código, la documentación y las aplicaciones de notas. La extensión del archivo es .md y, al ser texto plano, se lleva bien con el control de versiones.

¿Qué es Tabla Markdown?

Una tabla Markdown se compone de filas cuyas celdas van separadas por barras verticales y lleva, justo bajo el encabezado, una fila de alineación hecha de guiones. Esa segunda fila es obligatoria: anuncia que empieza la tabla e indica con dos puntos si las columnas se alinean a la izquierda, al centro o a la derecha. Dentro de una celda no caben tablas, listas ni saltos de línea; ese es el precio de la portabilidad.

¿Qué es Fila de alineación?

La fila de alineación es la línea de guiones situada bajo el encabezado de la tabla, escrita columna por columna. La posición de los dos puntos decide la alineación: a la izquierda de los guiones, la columna se alinea a la izquierda; a la derecha, a la derecha; a ambos lados, se centra; sin dos puntos, se aplica el valor por defecto del renderizador. El número de celdas de esta fila debe coincidir con el del encabezado; si no, la tabla no se reconoce como tabla.

¿Cuál es la diferencia entre un CSV y una tabla Markdown?

El CSV se diseñó para que lo lean las máquinas: aparte del carácter separador no lleva ningún adorno, y no conoce conceptos como ancho de columna o alineación. La tabla Markdown se diseñó para que la lean las personas; lleva la información de alineación y parece una tabla incluso en su forma de texto. A cambio, una tabla Markdown no se puede importar a una base de datos. Esta herramienta convierte el CSV en una tabla lista para publicar; para el camino inverso hay que volver a convertir la tabla en datos.

¿Qué alineación elegir?

En Markdown la alineación se indica con dos puntos en la fila de guiones bajo el encabezado, y vale para toda la tabla. Esta herramienta aplica una sola alineación; si quiere una distinta por columna, basta con retocar a mano la fila de guiones en la salida.

En la práctica, en tablas de importes, cantidades y fechas la alineación a la derecha facilita mucho la lectura: las cifras quedan unas debajo de otras. En tablas sobre todo de texto, la izquierda es la posición natural.

• Izquierda — columnas de texto: nombre, descripción, estado
• Centro — etiquetas cortas, símbolos, códigos de una letra
• Derecha — importe, cantidad, porcentaje, fecha

¿Dónde puede usar la salida?

Las tablas Markdown se renderizan igual en los repositorios de GitHub y GitLab, en los archivos README, en las páginas de wiki, en los generadores de sitios estáticos y en muchas aplicaciones de notas.

Después de pegar la tabla en un documento puede seguir editándola: para añadir una fila, escriba una línea nueva con el mismo número de barras verticales. Aunque los espacios de relleno se descuadren, la tabla se renderiza bien; los espacios solo están ahí por legibilidad.

¿A qué prestar atención en sus datos?

La fila de encabezado es obligatoria. Si sus datos no la tienen, añada una fila arriba; de lo contrario, su primer registro aparecerá como encabezado.

Si las filas no tienen el mismo número de columnas, manda la más ancha y las celdas que faltan quedan vacías; la tabla no se rompe. Una celda vacía no da ningún problema en Markdown.

Preguntas frecuentes

¿La primera fila tiene que ser un encabezado?

Sí. Por definición, una tabla Markdown lleva una fila de encabezado y, debajo, una fila de alineación. Si sus datos no tienen encabezado, añada usted una fila arriba.

¿Qué pasa si una celda contiene una barra vertical?

Se escapa con una barra invertida y se muestra como un carácter normal en la tabla. Sin ese escape, partiría la columna en dos y descuadraría la fila.

¿Se admiten celdas de varias líneas?

El salto de línea dentro de las comillas se sustituye por una etiqueta <br>, porque en una tabla Markdown cada celda debe caber en una sola línea. La mayoría de los renderizadores muestran <br> como un salto de línea.

¿Puedo alinear cada columna de forma distinta?

La herramienta aplica una sola alineación. Si quiere variarla, mueva a mano los dos puntos de la segunda fila de la salida; el resto de la tabla no hay que tocarlo.

¿Mis datos se envían a algún sitio?

No. El análisis y la construcción de la tabla ocurren en su navegador; lo que pega no se envía a ningún servidor.