Las tablas Markdown: una guía completa de la sintaxis de las tablas GFM

Las tablas Markdown le permiten mostrar datos estructurados en un formato legible que se presenta como una tabla HTML. Esta guía abarca la totalidad de GFM (GitHub Saborizado Markdown) sintaxis de la tabla, opciones de alineación, patrones avanzados y cómo convertir las tablas Word a Markdown.

Síntaxis básica de la tabla

Una tabla Markdown tiene tres partes:

1. Línea de encabezado Nombres de las columnas
2. Línea del separador tableros con tubos, define la tabla
3. Las filas de datos el contenido

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

Se presenta como:

Alineación de las columnas

Utilizar puntos en la fila separadora para controlar la alineación:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |

• :--- Alinear a la izquierda (default)
• :---: Alinear el centro
• ---: Alinearse a la derecha

Formatear dentro de las celdas de la tabla

La mayoría de los formatos Markdown en línea funcionan dentro de las celdas de la tabla:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

Lo que no funciona: contenido de varias líneas, listas anidadas, elementos de nivel de bloque.

Caracteres del tubo en las células

Si necesitas una pipa literal | dentro de una celda, escapar de ella con una barra de retroceso:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

Tablas sin espaciamiento

El espaciamiento alrededor de las tuberías es opcional. Esto es válido:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

Pero el espaciamiento consistente hace que las tablas sean más legibles. La mayoría de los editores y linters prefieren el formato espaciado.

Células vacías

Dejar el espacio entre los tubos vacío para una celda vacía:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

Convertir las tablas Word a Markdown

Las tablas Word se convierten automáticamente cuando se utiliza WordToMD. The converter handles:

• Cuadrícula estándar → GFM tablas de tuberías
• Anchos de columna → estandarizado (Markdown no controla el ancho de columna)
• Formato de texto dentro de las celdas → conservado (en negrita, cursiva, enlaces)

Lo que no convierte:

• Células fusionadas (intervalo/intervalo de filas) colapsadas a la célula más cercana
• Contenido de celdas de varias líneas rupturas de línea eliminadas
• Mesas anidadas mesas interiores aplanadas

Cuadros de manipulación complejos Word

Células fusionadas

Las células fusionadas de Word no tienen equivalente Markdown. Las opciones:

1. Reestructuración Dividir las filas fusionadas en tablas separadas
2. Utilizar HTML La mayoría de los procesadores Markdown aceptan la sintaxis de la tabla HTML:

<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

Contenido de la celda de varias líneas

Utilización <br> para las interrupciones de línea dentro de las celdas (funciona en GitHub y la mayoría de las plataformas):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

Mesas grandes

Para las tablas con muchas columnas, considere si una tabla es el formato correcto. Las alternativas:

• Una lista de definiciones (término + descripción)
• Múltiples tablas más pequeñas por categoría
• Un bloque de código para datos estructurados (JSON, YAML)

Rendición de tablas por plataforma

Accesiblidad

Para una mejor accesibilidad, asegúrese de que las tablas tengan una fila de encabezado con nombres de columnas significativos. Los lectores de pantalla usan la fila de encabezado para anunciar el contexto de la celda.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

Evitar el uso de tablas con fines de diseño utilizarlas únicamente para los datos de tablas reales.

FAQ

¿Por qué mi tabla de renderizado no se muestra como texto sin formato? La línea de separación (la |---|---| En el caso de los Estados miembros, la aplicación de las disposiciones de la presente Directiva es obligatoria. Sin él, el analizador no reconocerá la estructura de la tabla.

¿Puedo tener una mesa sin una fila de encabezado? No en GFM estándar. Se requieren la fila de encabezado y el separador. Si no desea un encabezado visible, use un encabezado en blanco: | | | con una fila separadora.

¿Por qué mis tablas de Word se ven bien en WordToMD pero mal después de pegarlos en otro lugar? El problema suele ser el espacio en blanco en las celdas o caracteres de tubería inconsistentes. La mayoría de los renderizadores Markdown son indulgentes, pero el copiar-pegar puede introducir caracteres invisibles.

¿Cómo puedo crear una tabla de forma programática a partir de datos? Las bibliotecas como markdown-table (npm) o Pythons tabulate puede generar tablas Markdown a partir de matrices. Esto es útil para la conversión por lotes de CSV o datos de base de datos.

Guías relacionadas

• ¿Qué es Markdown? Markdown conceptos básicos
• Markdown Sintaxis guía rápida Referencia completa de la sintaxis
• Cómo convertir Word a Markdown Guía de conversión completa
• DOCX a Markdown con Tablas Se centra en la conversión de tablas

Conclusión

Las tablas Markdown son potentes para la visualización de datos estructurados y son ampliamente compatibles con todas las principales plataformas. Para las tablas que comienzan en Word, WordToMD los convierte automáticamente a la sintaxis GFM. Para diseños complejos, el reparo HTML y los trucos anteriores le dan el control que necesita.