La sintaxis para crear tablas en Markdown es simple y fácil de leer. Pero, escribirlas puede ser un poco más enfarragoso (al final del articulo te aconsejo alguna herramienta)
Simplemente se utilizan guiones (-) para definir las cabeceras de las columnas y barras verticales (|) para separar las columnas.
Vamos a ver un ejemplo básico de una tabla en Markdown:
| Encabezado 1 | Encabezado 2 | Encabezado 3 |
|--------------|--------------|--------------|
| Dato 1 | Dato 2 | Dato 3 |
| Dato 4 | Dato 5 | Dato 6 |Este código se renderiza como:
| Encabezado 1 | Encabezado 2 | Encabezado 3 |
|---|---|---|
| Dato 1 | Dato 2 | Dato 3 |
| Dato 4 | Dato 5 | Dato 6 |
Componentes de una Tabla en Markdown
- Encabezados de Columna: La primera fila de la tabla, que define los nombres de las columnas. Se separan por barras verticales (
|) y se subrayan con guiones (-). - Separadores de Columna: Los guiones (
-) debajo de los encabezados indican el comienzo de las filas de datos. - Filas de Datos: Cada fila de datos sigue el mismo formato de separación por barras verticales (
|).
Las tablas en Markdown son mucho más limitadas que en otros lenguajes, como HTML. Por ejemplo, no es posible crear una tabla sin encabezado, o crear celdas combinadas
Alineación de Columnas
Markdown permite alinear el texto dentro de las columnas a la izquierda, derecha o centro. Esto se logra mediante el uso de dos puntos (:) en los separadores de las columnas.
- Alineación a la izquierda: Se utiliza
:---. - Alineación a la derecha: Se utiliza
---:. - Alineación al centro: Se utiliza
:---:.
Ejemplo de alineación:
| Izquierda | Centro | Derecha |
|:------------ |:------------:| ------------:|
| Dato 1 | Dato 2 | Dato 3 |
| Dato 4 | Dato 5 | Dato 6 |Esto se renderiza como:
| Izquierda | Centro | Derecha |
|---|---|---|
| Dato 1 | Dato 2 | Dato 3 |
| Dato 4 | Dato 5 | Dato 6 |
Herramientas para Crear Tablas en Markdown
Aunque es posible crear tablas manualmente, es un pequeño infierno crear tablas su vuestro editor no os ayuda un poco (por ejemplo indentando automáticamente la tabla)
Afortunadamente existen varias herramientas y editores que facilitan este proceso:
- Markdown Table Generator: Herramientas en línea como TablesGenerator nos ayudarán a crear y personalizar tablas de manera visual.
- Plugins de editores de texto: Editores como Visual Studio Code y Obsidian tienen extensiones que ayudan a formatear tablas en Markdown, e incluso copiar desde o a una hoja de cálculo.
Buenas prácticas Consejos
Simplicidad: Mantén las tablas simples y fáciles de leer. Es el único consejo que te puedo dar. No hagas una tabla gigante infumable.