En este artículo
¿Qué son las tablas Markdown?
Las tablas de Markdown usan caracteres de barra vertical (|) y guiones (-) para crear datos tabulares estructurados dentro de documentos de texto plano. Forman parte de GitHub Flavored Markdown (GFM) y son compatibles con la mayoría de los renderizadores de Markdown, incluidos GitHub, GitLab, VS Code y los generadores de sitios estáticos.
Las tablas en Markdown están diseñadas para la presentación simple de datos — encabezados de columna, fila separadora y filas de datos. Se renderizan como tablas HTML correctas en la salida, lo que las hace ideales para documentación, archivos README y escritura técnica sin conocimiento de HTML.
Sintaxis de tablas Markdown
Una tabla de Markdown consta de tres partes: la fila de encabezado, la fila separadora y una o más filas de datos.
- Fila de encabezado — la primera fila define los nombres de las columnas, separados por caracteres de barra vertical (|). Las barras verticales iniciales y finales son opcionales, pero se recomiendan para mayor claridad.
- Fila separadora — la segunda fila usa guiones (---) entre barras verticales para separar el encabezado de los datos. Se requieren al menos tres guiones por columna.
- Filas de datos — cada fila posterior contiene valores de celda separados por barras verticales. Las celdas no necesitan alinearse visualmente, aunque las columnas alineadas mejoran la legibilidad del código fuente.
- Escapar barras verticales — si el contenido de una celda contiene un carácter de barra vertical literal, escápelo con una barra invertida (\|) para evitar que se interprete como separador de columnas.
Opciones de alineación de columnas
La alineación de columnas se controla agregando dos puntos a la fila separadora. Esto determina cómo se alinea el texto dentro de cada columna.
- Alineación izquierda (predeterminada) — use :--- o --- en el separador. El texto se alinea al borde izquierdo de la columna. Este es el valor predeterminado cuando no se especifican dos puntos.
- Alineación central — use :---: en el separador. El texto se centra dentro de la columna. Útil para etiquetas de estado, categorías o valores cortos.
- Alineación derecha — use ---: en el separador. El texto se alinea al borde derecho. Ideal para valores numéricos, precios, recuentos y medidas.
Pruébalo gratis — sin registro
Generar tablas Markdown →Casos de uso comunes
Las tablas de Markdown se usan donde se necesita presentar datos estructurados en la documentación.
- Documentación README — tablas de comparación de funciones del proyecto, requisitos de instalación, plataformas compatibles y matrices de compatibilidad de versiones
- Documentación de API — referencias de endpoints con tablas de método, ruta, descripción y parámetros para cada ruta
- Tablas de comparación — comparaciones de funciones lado a lado, niveles de precios y evaluaciones de herramientas en publicaciones de blog y reseñas técnicas
- Registros de cambios — tablas de historial de versiones con fecha, número de versión y descripción de cambios para cada lanzamiento
Consejos y buenas prácticas
Seguir estas pautas ayuda a mantener sus tablas de Markdown legibles tanto en la forma de código fuente como en la renderizada.
- Mantenga las columnas alineadas en el código fuente — rellene las celdas con espacios para que las columnas se alineen visualmente. La mayoría de los editores y nuestro generador lo hacen automáticamente. El código fuente alineado es mucho más fácil de revisar en las solicitudes de cambios.
- Evite contenido complejo en las celdas — las tablas de Markdown no admiten contenido de celdas multilínea, elementos de bloque ni tablas anidadas. Mantenga el contenido de las celdas corto y simple. Para datos complejos, considere usar tablas HTML.
- Limite el número de columnas — las tablas con más de 5-6 columnas se vuelven difíciles de leer en pantallas más pequeñas. Considere dividir las tablas anchas en varias tablas más enfocadas o usar un formato diferente para datos muy amplios.
Preguntas frecuentes
¿Hay un límite para el contenido de las celdas en las tablas de Markdown?
No hay un límite técnico de caracteres para el contenido de las celdas, pero las celdas de las tablas de Markdown son solo de una línea. No puede incluir saltos de línea, párrafos ni elementos de nivel de bloque como listas dentro de una celda. Para contenido de celdas complejo, use tablas HTML con elementos <td> que admiten cualquier contenido HTML.
¿Puedo combinar celdas en las tablas de Markdown?
No. Las tablas de Markdown estándar no admiten colspan ni rowspan — cada fila debe tener el mismo número de columnas. La combinación de celdas requiere tablas HTML. Si necesita celdas combinadas, escriba la tabla en HTML e incrústela directamente en su documento Markdown.
¿Puedo anidar tablas dentro de tablas de Markdown?
No. Las tablas de Markdown no pueden anidarse. Cada tabla es una cuadrícula plana de filas y columnas. Si necesita datos jerárquicos, considere usar listas anidadas, tablas separadas con encabezados o tablas HTML con elementos <table> anidados.