Tablas en Markdown: cómo escribirlas y leerlas

Una tabla de Markdown es texto sin formato que se convierte en una cuadrícula. Escribes palabras, barras verticales | y guiones -. Un lector de Markdown muestra filas y columnas.

Las tablas están por todas partes en los archivos Markdown: listas de precios, planes, comparaciones, resultados de pruebas. Los chats de IA y los agentes de programación las escriben continuamente.

La tabla básica

| Fruta   | Color    | Precio |
|---------|----------|--------|
| Manzana | Rojo     | 1.20   |
| Plátano | Amarillo | 0.50   |

Esto es lo que muestra:

FrutaColorPrecio
ManzanaRojo1.20
PlátanoAmarillo0.50

Tres tipos de filas:

  1. Fila de encabezado: los nombres de las columnas.
  2. Fila de guiones: separa el encabezado del resto. Es obligatoria. Sin ella, no hay tabla.
  3. Filas de datos: una línea por fila.

Las barras verticales | separan las celdas. Las barras del principio y del final de cada línea son opcionales, pero hacen que la tabla sea más fácil de leer.

Las columnas no tienen que quedar alineadas en tu texto. Esto también funciona:

| Fruta | Color | Precio |
|---|---|---|
| Manzana | Rojo | 1.20 |

Deja una línea vacía antes y después de la tabla. La tabla termina en la primera línea vacía.

Alinear columnas

Añade dos puntos : a la fila de guiones:

| Izquierda | Centro | Derecha |
|:----------|:------:|--------:|
| a         | b      | 1.20    |
| aa        | bb     | 10.50   |
IzquierdaCentroDerecha
ab1.20
aabb10.50

Formato dentro de una celda

Las celdas pueden contener negrita, cursiva, code y enlaces:

| Tarea      | Estado    | Enlace                       |
|------------|-----------|------------------------------|
| Escribir   | **Hecho** | [Notas](https://example.com) |
| `npm test` | *En curso*|                              |

Para poner una barra vertical dentro de una celda, escríbela como \|. Si no, empieza una celda nueva. Esto también se aplica dentro de code.

Lo que las tablas no pueden hacer

Tablas anchas

Una tabla con muchas columnas se vuelve ancha, sobre todo en un teléfono. Algunos consejos:

Formas rápidas de crear una tabla

Cómo leer tablas de Markdown

En un editor de texto sin formato, una tabla sigue siendo barras verticales y guiones. Es legible para tablas pequeñas, pero difícil para las grandes. Un lector de Markdown muestra la cuadrícula de verdad.

PilcrowMD muestra tablas de Markdown en Android y Mac. Las celdas pueden mostrar negrita, cursiva, enlaces y fórmulas matemáticas. En Android, una tabla ancha se desplaza hacia los lados, para que las columnas no queden apretadas.

Preguntas frecuentes

¿Una tabla de Markdown es igual en todas partes? Casi. Las tablas forman parte de GitHub Flavored Markdown, que siguen la mayoría de las apps. Algunas apps de Markdown muy sencillas no muestran tablas en absoluto.

¿Puedo añadir un salto de línea dentro de una celda? No en el Markdown estándar. Algunas apps aceptan la etiqueta HTML <br>, pero no todas.

¿Tengo que alinear las barras verticales? No. Solo hace que el texto sea más fácil de leer.

También en Mac: PilcrowMD para Mac (beta)