Tablas en Markdown

Las tablas en Markdown permiten organizar información en filas y columnas de manera sencilla. Son muy útiles en documentación técnica, comparaciones, resúmenes y presentación de datos estructurados.

👉 Fueron añadidas como extensión en variantes como GitHub Flavored Markdown (GFM), ya que el Markdown clásico (2004) no incluía soporte para tablas.

12.1 Sintaxis básica con | y -

La estructura mínima de una tabla es:

| Columna 1 | Columna 2 | Columna 3 |
|-----------|-----------|-----------|
| Fila 1A   | Fila 1B   | Fila 1C   |
| Fila 2A   | Fila 2B   | Fila 2C   |

Renderizado:

Columna 1Columna 2Columna 3
Fila 1AFila 1BFila 1C
Fila 2AFila 2BFila 2C

👉 Explicación:

  • La primera fila define los encabezados.
  • La segunda fila (con ---) separa encabezados del contenido.
  • Cada fila posterior representa datos.
  • Los | (pipes) delimitan las columnas.

12.2 Alineación de columnas

Se pueden alinear los textos de las columnas con : en la fila de separación.

Alineación a la izquierda (por defecto):

| Izquierda | Centro | Derecha |
|:----------|:------:|---------:|
| texto 1   | texto 2| texto 3  |

Renderizado:

IzquierdaCentroDerecha
texto 1texto 2texto 3

👉 Reglas:

  • :--- alineación a la izquierda.
  • :---: alineación al centro.
  • ---: alineación a la derecha.

12.3 Ejemplo con distintos tipos de datos

| Nombre     | Edad | Ciudad        |
|:-----------|:---:|--------------:|
| Ana        | 23  | Córdoba       |
| Juan       | 30  | Buenos Aires  |
| Valentina  | 19  | Mendoza       |

Renderizado:

NombreEdadCiudad
Ana23Córdoba
Juan30Buenos Aires
Valentina19Mendoza

12.4 Tablas con formato extendido

Las tablas también admiten:

Celdas vacías:

| Producto   | Precio | Stock |
|------------|--------|-------|
| Teclado    | $15000 |  25   |
| Mouse      | $9000  |       |

Renderizado:

ProductoPrecioStock
Teclado$1500025
Mouse$9000

Formato dentro de las celdas:

| Lenguaje   | Estado      |
|------------|-------------|
| **Python** | Popular     |
| *Rust*     | Emergente   |
| ~~Perl~~   | En desuso   |

Renderizado:

LenguajeEstado
PythonPopular
RustEmergente
PerlEn desuso

Enlaces e imágenes:

| Recurso | Enlace |
|---------|--------|
| GitHub  | [Visitar](https://github.com) |
| Logo    | ![Markdown](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg) |

Renderizado:

RecursoEnlace
GitHubVisitar
LogoMarkdown

12.5 Limitaciones

  • No se soportan columnas combinadas (colspan/rowspan) como en HTML.
  • El formato depende del visor: algunos renderizadores muestran bordes, otros solo alineación.
  • Tablas muy anchas pueden ser difíciles de leer en móviles.

12.6 Buenas prácticas

  • Mantener alineación coherente en columnas (por ejemplo, números a la derecha, texto a la izquierda).
  • Usar espacios consistentes para mejorar legibilidad en el archivo .md.
  • Evitar tablas demasiado grandes; considerar dividir en varias más simples.
  • Usar tablas solo para datos tabulares, no para maquetar todo el documento.
  • Cuando se comparta en GitHub, usar alineaciones claras para facilitar lectura directa en texto plano.

12.7 Ejemplo completo

# Ejemplo de tablas en Markdown

## Tabla básica
| Columna 1 | Columna 2 |
|-----------|-----------|
| Dato A    | Dato B    |
| Dato C    | Dato D    |

## Tabla con alineación
| Producto | Precio | Stock |
|:---------|-------:|:-----:|
| Teclado  | $15000 |  25   |
| Mouse    | $9000  |   0   |
| Monitor  | $85000 |  10   |

## Tabla con formato y enlaces
| Lenguaje   | Info |
|------------|------|
| **Python** | [Web oficial](https://www.python.org) |
| *JavaScript* | [Documentación](https://developer.mozilla.org/es/docs/Web/JavaScript) |

Renderizado:

Ejemplo de tablas en Markdown

Tabla básica

Columna 1Columna 2
Dato ADato B
Dato CDato D

Tabla con alineación

ProductoPrecioStock
Teclado$1500025
Mouse$90000
Monitor$8500010

Tabla con formato y enlaces

LenguajeInfo
PythonWeb oficial
JavaScriptDocumentación

Conclusión

Las tablas en Markdown se crean con pipes (|) y guiones (-). La alineación de columnas se logra con :--- (izquierda), :---: (centro) y ---: (derecha). Admiten formato enriquecido dentro de las celdas (negrita, cursiva, enlaces, imágenes). Son simples pero limitadas frente a las tablas HTML; ideales para documentación técnica clara y ligera.

¿Listo para practicar lo aprendido? Visita el visor de Markdown y pon en práctica los conceptos.

Retornar