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 ejemploprimera 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:
- Repetir el valor para que la tabla sea regular.
- Dividirla en dos tablas más pequeñas.
- 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.