Tablas en Markdown: guía completa

Las tablas son de lo más útil de Markdown, y también de lo más fácil de escribir mal. Esta guía va desde el formato básico hasta la alineación, los saltos de línea, los caracteres especiales y la conversión desde hojas de cálculo. Para probar los ejemplos, pégalos en el editor de Markdown online y verás el resultado al instante.

Sintaxis básica

Una tabla tiene tres partes: fila de encabezado, fila separadora y filas de datos. Las columnas se separan con |.

| Nombre | Equipo | Ext. |
| --- | --- | --- |
| Ana | Ventas | 101 |
| Luis | Diseño | 205 |

Resultado:

Nombre Equipo Ext.
Ana Ventas 101
Luis Diseño 205

Puntos clave:

  • La fila separadora --- es obligatoria, con al menos tres guiones por columna.
  • Las | de los extremos son opcionales, pero facilitan la lectura.
  • Cada fila debe tener el mismo número de columnas que el encabezado.
  • Deja una línea en blanco antes y después de la tabla.

Alineación de columnas

Añade dos puntos : en la fila separadora:

| Izquierda | Centro | Derecha |
| :--- | :---: | ---: |
| Manzanas | 10 | 3,00 € |
| Plátanos | 5 | 1,50 € |
Izquierda Centro Derecha
Manzanas 10 3,00 €
Plátanos 5 1,50 €

Alinea a la derecha números y precios para compararlos fácilmente.

Código, enlaces y negrita en las celdas

El Markdown en línea funciona dentro de las celdas:

| Comando | Descripción |
| --- | --- |
| `npm install` | Instala paquetes, ver la [documentación](https://docs.npmjs.com/) |
| **Obligatorio** | Este campo debe rellenarse |

Mostrar una barra vertical en una celda

La | se interpreta como separador de columnas, así que escápala con una barra invertida:

| Operador | Significado |
| --- | --- |
| `a \| b` | OR a nivel de bits |

Saltos de línea dentro de una celda

Las tablas de Markdown estándar no admiten saltos de línea dentro de una celda: cada fila debe ir en una sola línea. Soluciones habituales:

  • GitHub acepta <br>, por ejemplo primera línea<br>segunda línea.
  • Moread no ejecuta etiquetas HTML por seguridad, así que <br> se muestra como texto. Divide el contenido en varias filas o usa una lista.

Celdas combinadas

Las tablas de Markdown estándar no pueden combinar celdas. Alternativas:

  1. Repetir el valor para que la tabla sea regular.
  2. Dividirla en dos tablas más pequeñas.
  3. Si el contenido es complejo, una lista o subtítulos suelen ser más claros.

Convertir desde Excel o Google Sheets

Al copiar celdas de una hoja de cálculo obtienes texto separado por tabuladores. Para convertirlo:

  • Sustituye los tabuladores por | en un editor de texto, añade | al principio y al final de cada fila e inserta la fila separadora.
  • O usa un conversor «Excel to Markdown».

Después pégalo en el editor online para comprobar las columnas.

Tablas anchas

Las tablas con muchas columnas pueden desbordarse en el móvil. Moread permite desplazarlas en horizontal para no romper el diseño. Al escribir, también ayuda:

  • Quitar columnas que no sean imprescindibles.
  • Usar palabras clave cortas en las celdas y explicar los detalles debajo.

Plantilla rápida

| Concepto | Cant. | Importe |
| :--- | ---: | ---: |
| Concepto uno | 1 | 100 |
| Concepto dos | 2 | 250 |
| **Total** | **3** | **350** |

Más sintaxis en la guía de sintaxis Markdown; para convertir tus tablas en un informe, consulta Markdown a PDF.