Generador de Tablas Markdown

Qué es realmente una tabla Markdown

Las tablas Markdown no forman parte de la especificación original de Markdown; provienen de GitHub Flavored Markdown, el dialecto popularizado por GitHub y que hoy se admite casi en todas partes donde escriben los desarrolladores. La sintaxis es deliberadamente texto plano: las columnas se separan con el carácter de barra vertical, la fila de encabezado va arriba y una segunda fila de guiones divide el encabezado del cuerpo. Como no es más que texto, una tabla Markdown se mantiene legible en su forma en bruto y sobrevive al copiar y pegar, a los diffs del control de versiones y al correo de un modo que una tabla HTML nunca podría.

Esta herramienta elimina la tediosa tarea de alinear esas barras verticales. Pegas filas corrientes, ella averigua las columnas y escribe una tabla bien formada con el encabezado, la fila divisoria y cada celda en su sitio.

La anatomía de la sintaxis

Una tabla mínima son tres líneas. La primera línea enumera los encabezados separados por barras verticales, por ejemplo Name, luego una barra vertical y luego Role. La segunda línea es el separador: un grupo de guiones por columna, como tres guiones, una barra vertical, tres guiones. Cada línea posterior es una fila de datos que usa el mismo patrón de barras verticales. Las barras verticales exteriores al principio y al final de cada línea son opcionales en GFM, pero incluirlas hace que el texto en bruto sea más fácil de leer y es lo que produce este generador.

La fila separadora cumple una doble función: por un lado, señala que la línea de arriba es un encabezado y, por otro, mediante la colocación de los dos puntos, declara cómo se alinea cada columna. Por eso una tabla Markdown siempre necesita al menos una fila de encabezado y una fila separadora para poder renderizarse.

Definir la alineación de las columnas

La alineación reside por completo en los guiones de la fila separadora, controlada por los dos puntos. Unos dos puntos a la izquierda de los guiones alinean la columna a la izquierda, unos dos puntos a ambos lados la centran, y unos dos puntos a la derecha la alinean a la derecha. Así, una columna centrada se escribe como dos puntos, unos guiones y luego dos puntos, mientras que una columna alineada a la derecha termina en dos puntos. La alineación a la derecha es la elección convencional para las columnas numéricas, de modo que los dígitos queden alineados por valor posicional.

Elegir Izquierda, Centro o Derecha en esta herramienta escribe por ti esos marcadores de dos puntos en toda la tabla, lo que significa que la alineación se renderiza de forma idéntica en GitHub, en los generadores de documentación y en cualquier otro visor de GFM, en lugar de depender de la configuración del lector.

Un ejemplo resuelto

Pega tres líneas separadas por comas, Name, Role, City arriba, seguidas de Ada Lovelace, Engineer, London y Grace Hopper, Admiral, New York. Con la alineación al centro seleccionada, la herramienta emite una fila de encabezado con los tres títulos, una fila separadora donde los guiones de cada columna van envueltos en dos puntos, y dos filas de datos. Pegada en un README de GitHub, se renderiza como una pulcra tabla de tres columnas con los valores centrados, sin necesidad de contar barras verticales a mano.

Escapar barras verticales y otras trampas

La barra vertical es el separador de columnas, así que una barra vertical literal dentro de una celda normalmente partiría esa celda en dos y arruinaría la tabla. Esta herramienta escapa automáticamente cualquier barra vertical de tus datos escribiéndola como una barra invertida seguida de una barra vertical, de modo que un valor como una expresión lógica que contiene un símbolo OR permanece en una sola celda y se muestra como corresponde.

Hay otras dos cosas que conviene saber. Las tablas Markdown no pueden contener saltos de línea forzados dentro de una celda usando la tecla Intro; si necesitas un salto dentro de una celda, tendrías que insertar una etiqueta br explícita, ya que GFM permite HTML en línea. Y cada fila debería tener el mismo número de columnas que el encabezado. La mayoría de los renderizadores ignoran las celdas sobrantes de una fila y las celdas que faltan se renderizan como vacías, así que mantén tus filas rectangulares para obtener resultados predecibles.

Separadores y valores entre comillas

Los datos reales no siempre llegan separados por comas. Dejar el separador en Auto permite que la herramienta detecte si tus filas usan comas, tabulaciones o barras verticales, lo que significa que tanto un bloque copiado directamente de una hoja de cálculo (separado por tabulaciones) como una exportación CSV (separada por comas) se convierten sin ninguna configuración. También puedes forzar un separador concreto cuando la detección automática adivinaría mal, como en datos que contienen legítimamente muchas comas.

Los valores CSV entre comillas también se gestionan correctamente. Una coma dentro de comillas dobles se trata como parte del valor, de modo que un campo como una entrada entre comillas con el apellido primero permanece en una sola celda en lugar de fracturarse en dos columnas. Esto importa porque las exportaciones de hojas de cálculo entrecomillan de forma rutinaria cualquier valor que contenga el propio delimitador.

Dónde funcionan las tablas Markdown y dónde no

Las tablas Markdown brillan en contextos de desarrollo y de escritura: los README, las incidencias y las solicitudes de incorporación de cambios de GitHub y GitLab; los generadores de sitios estáticos y de documentación; muchas wikis y apps de notas; herramientas de chat como Slack y Discord en sus campos compatibles con Markdown; y los comentarios de Reddit. En cualquier sitio donde se admita GFM, una tabla pegada simplemente funciona y se mantiene legible en su forma de código.

No son universales, sin embargo. El Markdown simple sin la extensión GFM no entiende las tablas, y algunos renderizadores ligeros las ignoran, en cuyo caso las barras verticales en bruto quedan a la vista. Las tablas Markdown también carecen de un control fino del estilo, de celdas combinadas y de estructura anidada. Cuando necesitas un formato preciso, colspans o un estilo rico, una tabla HTML es la mejor opción; cuando quieres una tabla limpia, controlable por versiones y legible por humanos, gana Markdown.