Generador de tablas Markdown desde CSV o TSV

Escribir una tabla en Markdown a mano es tedioso: hay que contar barras verticales, cuadrar la fila de guiones y acordarse de escapar los caracteres que rompen el formato. Esta herramienta parte de datos que ya tienes en CSV o TSV —de una hoja de cálculo, de una exportación o de una consulta SQL— y devuelve el bloque listo para pegar. El analizador respeta RFC 4180, así que los campos entre comillas con comas o saltos de línea dentro no arruinan el resultado.

¿Qué es el Generador de tablas Markdown?

Es un conversor que transforma datos delimitados —CSV, TSV o texto separado por punto y coma— en una tabla con la sintaxis de GitHub Flavored Markdown. Cada línea se interpreta como una fila y cada campo como una celda, y el resultado es un bloque de texto que puedes pegar tal cual en un README, en una incidencia o en tu documentación. No es un editor visual con celdas: pegas los datos tal como salen de su origen y recibes el Markdown ya formateado, con las columnas rellenadas al mismo ancho.

Cómo funciona el generador de tablas

El texto pegado se analiza con un lector conforme a RFC 4180, no con un simple split: un campo entrecomillado puede contener el delimitador, un salto de línea o unas comillas dobles que representan una comilla literal. Si dejas el delimitador en automático, se examina la primera línea en busca de tabuladores, puntos y comas y comas, y gana el más frecuente. Cada celda se escapa después para Markdown: una barra vertical suelta pasa a \| y los saltos de línea internos se convierten en un espacio, porque una fila de tabla GFM debe caber en una sola línea. Por último, cada columna se rellena hasta el ancho de su celda más larga, de modo que el Markdown en bruto siga siendo legible en un diff aunque el relleno no altere la tabla renderizada.

Características

Analizador conforme a RFC 4180: campos entre comillas, comillas dobles escapadas ("") y saltos de línea dentro de un campo entrecomillado.

Detección automática del delimitador a partir de la primera línea, probando tabulación, punto y coma y coma; también puedes imponerlo.

Escapa las barras verticales del contenido como \| y aplana los saltos de línea dentro de una celda, porque ambos romperían la tabla.

Rellena todas las columnas al mismo ancho y genera la fila separadora según la alineación elegida: ---, :-: o --:.

Cómo usar el generador

Pega tu CSV o TSV en el campo de datos, con una fila por línea.

Deja el delimitador en detección automática o fíjalo a mano si la primera línea no representa al resto del contenido.

Elige la alineación (izquierda, centro o derecha) e indica si la primera fila contiene los encabezados.

Copia el bloque Markdown generado y pégalo en tu README, tu incidencia o tu página de documentación.

Errores frecuentes

Pegar datos con comillas sin cerrar: al seguir RFC 4180, todo lo que viene después se absorbe dentro del mismo campo, saltos de línea incluidos. Comprueba que cada comilla tenga su pareja.

Esperar que la alineación desplace el texto en el bloque en bruto: la alineación solo cambia la fila separadora (--- , :-: o --:); el desplazamiento visual lo aplica el renderizador de Markdown.

Confiar en la detección automática cuando la primera línea no es representativa: solo se examina esa línea, así que un encabezado con punto y coma seguido de filas con comas acaba en una única columna. En ese caso, fija el delimitador.

Ejemplos

nombre,edad\nAna,31 -> | nombre | edad |\n| ------ | ---- |\n| Ana | 31 |

producto,nota\nA|B,ok -> | producto | nota |\n| -------- | ---- |\n| A\|B | ok |

sku;total\nA1;9.50 con alineación a la derecha -> fila separadora | --: | ----: |

Ver también

CSV a JSON — ¿Quieres esas filas como datos estructurados en lugar de una tabla? Conviértelas a JSON.
Eliminar espacios — Los espacios iniciales sueltos aparecerán en cada celda: quítalos antes de pegar.

Preguntas frecuentes

¿Qué ocurre si una celda contiene el carácter |?

Se escapa automáticamente como \|. Una barra vertical sin escapar se interpretaría como separador de columna y partiría la fila en dos celdas, así que el escapado es obligatorio para conservar el contenido original.

¿Cómo se decide el delimitador cuando elijo detección automática?

Se examina únicamente la primera línea y se prueban tres candidatos en este orden: tabulación, punto y coma y coma. Si tus filas no siguen el mismo patrón que la primera línea, selecciona el delimitador manualmente en lugar de dejar la detección automática.

¿Puedo usar campos que contienen saltos de línea?

Sí, siempre que el campo vaya entre comillas dobles, tal como define RFC 4180; el analizador lo lee como un único valor. En la salida, sin embargo, ese salto de línea se aplana, porque una tabla Markdown no admite varias líneas dentro de una celda.

¿Por qué el Markdown generado tiene tantos espacios de relleno?

Cada columna se rellena hasta el ancho de su celda más larga para que el texto en bruto siga siendo legible y los diffs de Git resulten fáciles de revisar. Esos espacios no afectan al resultado renderizado: la tabla se ve idéntica con o sin relleno.