Hoja de referencia de tablas de Markdown
Todos los patrones de sintaxis de las tablas de Markdown en una página imprimible. Guárdala, hazle una captura o imprímela. La referencia que tu documentación te va a agradecer.
- Estructura básica
- Alineación
- Escapar una barra vertical literal
- Saltos de línea dentro de una celda
- Celdas vacías
- Formato en línea en las celdas
- Casillas de verificación dentro de las celdas (GitHub Flavored)
- Números: alinear siempre a la derecha
- La tabla de compatibilidad por plataforma
- El resumen de cinco reglas
Estructura básica
| Header A | Header B | Header C |
|----------|----------|----------|
| A1 | B1 | C1 |
| A2 | B2 | C2 |Alineación
| Left | Center | Right |
|:-----|:------:|------:|
| a | b | c |:---. Alineado a la izquierda (el valor por defecto si no hay dos puntos):---:. Centrado---:. Alineado a la derecha
Escapar una barra vertical literal
| Code | Meaning |
|:---------------|:-------------|
| a | b | a or b |
| a \| b | a or b (alt) |Tanto | como \| funcionan en la mayoría de los analizadores. Elige uno y mantente consistente dentro de un documento.
Saltos de línea dentro de una celda
| Name | Notes |
|:------|:-----------------------------|
| Alice | Senior engineer<br>Joined 2019 |La etiqueta <br> es la única forma fiable de forzar un salto de línea dentro de una celda de tabla de Markdown.
Celdas vacías
| Item | Status | Owner |
|:-----|:---------|:-------|
| A | Done | Alice |
| B | | Bob |
| C | Pending | |Las celdas vacías se quedan vacías. El motor de renderizado las trata como <td></td>.
Formato en línea en las celdas
| Token | Description |
|:--------|:----------------------------------|
| <br> | Line break |
| bold | **bold** renders as bold |
| italic | *italic* renders as italic |
| `code` | Backticks for monospace inline |
| [link](url) | Standard markdown link syntax |Casillas de verificación dentro de las celdas (GitHub Flavored)
| Task | Done |
|:---------------|:----:|
| Set up CI | [x] |
| Write tests | [x] |
| Deploy | [ ] |Números — alinear siempre a la derecha
| Item | Qty | Price | Total |
|:---------|----:|-------:|--------:|
| Coffee | 2 | $3.50 | $7.00 |
| Pastry | 3 | $4.00 | $12.00 |
| | | Total | $19.00 |La tabla de compatibilidad por plataforma
| Plataforma | Barras | Alineación | HTML | Casillas |
|---|---|---|---|---|
| GitHub | opcionales | sí | sí | sí |
| GitLab | opcionales | sí | sí | sí |
| obligatorias | sí | no | no | |
| Discord | obligatorias | limitada | no | no |
| Notion | opcionales | automática | limitado | según el tipo de columna |
| Obsidian | opcionales | sí | sí | sí |
| Stack Overflow | obligatorias | sí | no | no |
El resumen de cinco reglas
- Usa siempre barras al inicio y al final. No cuesta nada. Arregla Reddit y Stack Overflow.
- Incluye siempre la fila separadora. Sin ella, no hay tabla.
- Haz coincidir el número de columnas entre la fila de encabezado y las de datos.
- Alinea los números a la derecha, el texto a la izquierda y centra las etiquetas cortas.
- Escapa las barras como
|o\|cuando haga falta dentro de las celdas.
Para la referencia completa con ejemplos resueltos y trampas por plataforma, mira la guía completa de las tablas de Markdown. Para el recorrido del flujo de trabajo, mira cómo hacer una tabla de Markdown en 60 segundos.
Preguntas frecuentes
¿Puedo imprimir esta página?
Sí. La página tiene estilos de impresión. El cuadro de diálogo de impresión de tu navegador produce una referencia limpia de una sola página.
¿Dónde encuentro la salida renderizada lado a lado?
Usa la herramienta Tabla de Markdown. Muestra la vista previa en vivo y el Markdown en crudo uno al lado del otro.
¿Esto funciona para el markdown de los comentarios de Reddit?
Sí. Todos los patrones de esta página se renderizan correctamente en Reddit, GitHub y la mayoría de los demás entornos de Markdown.
¿Cómo agrego una columna de lista de tareas?
Usa la sintaxis de casilla de verificación de markdown dentro de una celda: [ ] para sin marcar, [x] para marcada. GitHub las renderiza como casillas reales.
Seguir leyendo
Escrito por SAVI. Creamos las herramientas sobre las que escribimos. Prueba la herramienta Tabla de Markdown que usamos en este artículo.