Tablas Markdown: la referencia completa

Todo sobre las tablas con barras de GFM (GitHub-flavored): anatomía, alineación, escapes, los errores que rompen el renderizado, y cómo mover las tablas entre herramientas.

Sintaxis básica

| Column A | Column B |
|----------|----------|
| cell 1   | cell 2   |
| cell 3   | cell 4   |

Tres partes: una fila de encabezado, una fila divisoria (mínimo guiones) y luego las filas de cuerpo. La fila divisoria debe existir — sin ella el texto es un párrafo, no una tabla. El espaciado del código fuente no necesita alinearse; importan las barras, no las columnas. Las barras inicial y final son opcionales pero recomendadas por portabilidad.

Alineación

Los dos puntos de la fila divisoria fijan la alineación de la columna — :--- izquierda (por defecto), :---: centro, ---: derecha:

| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |

La alineación es el único control a nivel de celda que ofrece GFM: sin fondo de celda, sin celdas combinadas, sin expansión de columnas.

Formato en línea dentro de las celdas

Las celdas aceptan Markdown en línea — negrita, cursiva, código en línea y enlaces — pero no elementos en bloque: nada de listas, encabezados ni tablas anidadas dentro de una celda. Cada fila es una línea del código fuente; los saltos largos necesitan un <br> explícito.

Errores comunes que rompen las tablas

Falta la línea en blanco antes de la tabla — pegada al párrafo, la mayoría de analizadores tratan las barras como texto.
Fila divisoria malformada — solo puede contener guiones, dos puntos y barras, con exactamente tantas celdas como la fila de encabezado.
Barra sin escapar dentro de una celda — una | literal parte la celda y desplaza cada columna posterior. Escápala como \|.
Filas desiguales — GitHub tolera las celdas finales que faltan (las muestra vacías), pero algunos analizadores y convertidores las marcan o rellenan, así que mantén las filas consistentes.
Tablas con sangría — cuatro espacios iniciales convierten todo el bloque en un cercado de código.

Pega una tabla sospechosa en el generador de tablas — renormaliza la alineación y los escapes a la forma canónica.

Mover tablas dentro y fuera de otras herramientas

Dirección	Herramienta	Notas
Excel / Sheets → Markdown	Excel a Markdown	Solo valores en caché; ceros iniciales preservados como texto
CSV / TSV → Markdown	CSV a Markdown	RFC-4180 completo: campos entre comillas, comas incrustadas, celdas multilínea
Markdown → Excel / CSV	Tabla Markdown a Excel	Todas las tablas detectadas; valores escritos como texto, sin convertirlos a la fuerza
Markdown → JSON	Markdown a JSON	La fila de encabezado se convierte en claves; inferencia de tipos con interruptor
Crear o reformatear una	Generador de tablas	Pega celdas o una tabla existente; alineación y escapes normalizados

Los cinco corren en tu navegador sin subidas — y la matriz de formatos admitidos documenta cómo gestiona cada exportador la alineación de tablas, las celdas multilínea y los escapes.

Tablas en GitHub, Reddit y Slack

GitHub renderiza el GFM completo, incluida la alineación y el formato en línea; deja una línea en blanco entre la tabla y el texto que la rodea.
Reddit admite tablas con barras en la mayoría de contextos (alineación incluida), pero no dentro de citas.
Slack y Discord no renderizan tablas — las barras se muestran literalmente. Para el chat, la herramienta Markdown → imagen convierte la tabla en una imagen para compartir.

Preguntas frecuentes

¿Cómo escribo un salto de línea dentro de una celda de tabla Markdown?

Usa una etiqueta HTML <br>: la regla de salto de línea de dos espacios de Markdown no funciona dentro de una fila de tabla, porque la fila es una única línea larga. La mayoría de renderizadores, incluido GitHub, aceptan <br> dentro de las celdas de tabla.

¿Markdown admite celdas combinadas?

No. Las tablas GFM no tienen colspan ni rowspan. Para mostrar datos combinados, repite el valor en cada fila o reestructura la tabla; algunos preprocesadores generan celdas repetidas a partir de datos con celdas que abarcan varias.

¿Por qué no se renderiza mi tabla Markdown?

Las tres causas habituales: falta la línea en blanco que separa la tabla del párrafo anterior, la fila de alineación está malformada (debe contener solo barras, guiones y dos puntos, en su propia línea) o hay barras sin escapar dentro de las celdas que parten las filas demasiado pronto.

¿Cuántas columnas puede tener una tabla Markdown?

El formato no pone límite — la legibilidad sí. A partir de unas siete columnas, las filas se vuelven difíciles de escanear en su forma fuente y a menudo desbordan el ancho de la página renderizada; considera transponer la tabla o dividirla.

¿Las tablas Markdown aparecen correctamente en Word y Excel?

No pegando — Word y Excel no tienen analizador de Markdown. Convierte primero: un convertidor consciente de la estructura convierte las tablas GFM en tablas de Word editables o hojas .xlsx reales, conservando filas de encabezado, alineación y ceros iniciales.