Cómo hacer una tabla en Markdown (sintaxis, alineación y generador gratis)

Las tablas son la única parte de Markdown incómoda de escribir: barras, guiones y una forma que se deshace en cuanto una celda crece. Aun así merecen la pena en archivos README, documentación y notas. Esta guía explica cómo funcionan y cómo evitar escribirlas a mano con el generador de tablas Markdown gratuito.

Sintaxis de las tablas Markdown

Una tabla se compone de líneas de texto. Las barras (|) separan las columnas, y una línea de guiones (---) separa la fila de títulos del resto:

| Plan     | Users | Price |
| -------- | ----- | ----- |
| Free     | 1     | $0    |
| Team     | 10    | $29   |
| Business | 50    | $99   |

Solo necesitas tres reglas:

• La primera línea siempre es la fila de títulos.
• La segunda línea debe tener un grupo de guiones por columna. Con tres guiones por columna basta.
• Deja una línea en blanco antes de la tabla, o algunos lectores no la reconocerán.

Las tablas no forman parte del Markdown original. Vienen del Markdown de GitHub, que admiten GitHub, GitLab y la mayoría de las herramientas modernas. Un lector de Markdown muy estricto puede mostrarlas como texto sin formato.

Los espacios son opcionales

Alinear las columnas solo hace más legible el texto. Esta versión más corta se ve exactamente igual una vez mostrada:

| Plan | Users | Price |
| --- | --- | --- |
| Free | 1 | $0 |
| Team | 10 | $29 |
| Business | 50 | $99 |

Cómo alinear columnas

Los dos puntos en la línea de guiones fijan la alineación de cada columna:

• :--- alinea a la izquierda.
• :---: centra.
• ---: alinea a la derecha, ideal para precios y otros números.

| Plan     | Users | Price |
| :------- | :---: | ----: |
| Free     |   1   |    $0 |
| Team     |  10   |   $29 |
| Business |  50   |   $99 |

Barras y saltos de línea dentro de una celda

Una | dentro de una celda abriría una columna nueva, así que se escribe \|. Además, una celda solo admite una línea, por lo que un salto de línea se escribe <br>, que GitHub muestra como una línea nueva dentro de la celda:

| Command | Meaning |
| --- | --- |
| a \| b | Pipe in a cell |
| Line one<br>Line two | Two lines |

La negrita, la cursiva, los enlaces y `code` funcionan en las celdas como siempre. Las listas y los bloques de código no, porque necesitan más de una línea.

Cómo crear una tabla sin escribir las barras

1. Abre el generador de tablas Markdown. Ejemplo rellena una de muestra.
2. Escribe en las celdas; la primera fila es la de títulos. Intro baja a la siguiente, y + Fila y + Columna añaden más.
3. Usa el menú sobre cada columna para elegir Izquierda, Centro o Derecha.
4. Revisa el resultado y haz clic en Copiar o Descargar.

Dos opciones cambian el aspecto del Markdown como texto, pero no cómo se muestra:

• Alinear columnas añade los espacios que ordenan el texto. Desactívala para un Markdown más corto.
• Barras en los bordes empieza y termina cada línea con |. Las dos formas funcionan en GitHub.

Cómo convertir Excel o Google Sheets en una tabla Markdown

Selecciona las celdas en tu hoja de cálculo y cópialas. Haz clic en una celda del generador y pega: las celdas se rellenan desde ahí, y se añaden las filas y columnas necesarias. También puedes hacer clic en Abrir archivo o soltar un archivo CSV o TSV en la herramienta. Admite hasta 500 filas y 26 columnas.

Cómo editar una tabla que ya tienes

Abre o suelta un archivo .md, o pega la tabla Markdown en una celda. La primera tabla que se encuentre se carga en la cuadrícula con su alineación, así puedes añadir una columna o cambiar el texto sin contar barras.

Más herramientas de Markdown

• Generador de README: crea un README completo y añade tu tabla. Consulta cómo escribir un buen README.
• Markdown a HTML: obtén la tabla como tabla HTML para tu web.

Preguntas frecuentes

¿Puedo combinar celdas en una tabla Markdown?

No. Las tablas Markdown no tienen celdas combinadas. Si de verdad las necesitas, usa una tabla HTML, que GitHub también acepta.

¿Puede una tabla Markdown no tener fila de títulos?

En GitHub no: la fila de títulos es obligatoria. Si no quieres títulos, deja esas celdas vacías.

¿Se sube mi tabla?

No. Se crea en tu navegador y nunca sale de tu dispositivo. Editar es gratis; copiar o descargar el Markdown cuenta como un uso de tu cupo diario.