Cómo crear una tabla en Markdown
¿Necesita dar formato a su información de forma práctica? Averigüemos cómo crear una tabla en un documento Markdown de forma fácil y sencilla. Veamos herramientas útiles y técnicas profesionales.
Intro
Empecemos por averiguar por qué son necesarias las tablas en los documentos markdown y veamos las formas más convenientes de insertar una tabla en un documento markdown de forma rápida y sencilla.
Las tablas se utilizan a menudo para organizar y presentar información de forma clara y concisa. Pueden emplearse para mostrar datos, comparar distintos valores o mostrar relaciones entre distintas piezas de información.
El uso de tablas también puede ayudar a que su documento sea visualmente más atractivo y más fácil de leer y comprender, sobre todo si tiene mucha información que presentar.
Así pues, las tablas siempre son útiles para organizar la información de forma que resulte fácil de comprender de un vistazo.
Sintaxis
Como tal, no existe una sintaxis para crear tablas en Markdown puro. Las tablas sólo se admiten en determinadas versiones de Markdown, como Markdown Extra o GitHub Flavored Markdown.
Y aquí puede encontrar documentación de GitHub sobre la organización de la información en forma de tablas. También podemos encontrar soporte para tablas en extended syntax Markdown.
Crear tabla
La forma más fácil y rápida de hacer una tabla Markdown es utilizar el Generador de tablas Markdown o el servicio AnyWayData.
Con estas herramientas, puede construir rápida y fácilmente una tabla con una interfaz gráfica agradable y, a continuación, puede copiar el texto Markdown resultante en su archivo.
Por otro lado, la sintaxis del lenguaje Markdown es lo suficientemente sencilla como para que pueda dibujar tablas usted mismo. Utiliza pipe o una barra vertical ( | ) para separar celdas y un guión ( - ) para hacer una línea de encabezado.
He aquí un ejemplo sencillo de código de tabla:
| |
Dicho código se mostrará en el documento acabado de la siguiente forma:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1 | Cell 2 | Cell 3 |
| Row 2 | Cell 5 | Cell 6 |
| Row 3 | Cell 8 | Cell 9 |
Tenga en cuenta que si necesita utilizar el símbolo de la línea vertical como contenido dentro de una celda, deberá escribir código HTML para dicho símbolo: |.
| |
Resultado:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1 | Cell 2 | 👉 | |
Alineación
Puede utilizar dos puntos ( : ) para controlar la alineación del texto en las columnas de la tabla. Observe los dos puntos en la línea con los guiones. El texto en el código de la tabla está desplazado a la izquierda en todas partes, pero en el resultado verá que está alineado en la dirección donde colocamos los dos puntos.
| |
En la columna de la izquierda, sólo utilizamos dos puntos en el lado izquierdo, para que el texto de toda la columna se alinee a la izquierda. En la columna central, utilizamos dos puntos tanto a la izquierda como a la derecha, de modo que el texto de esa columna está centrado. Y en la columna de la derecha, sólo pusimos dos puntos en el lado derecho, de modo que todo el texto está alineado a la derecha.
| Left-Aligned | Center Aligned | Right Aligned |
|---|---|---|
| Row 1 | Cell 2 | Cell 3 |
| Row 2 | Cell 5 | Cell 6 |
| Row 3 | Cell 8 | Cell 9 |
Dentro de las tablas, también podemos utilizar parte del formato markdown al que estamos acostumbrados: enlaces, texto inclinado, en negrita o tachado.
| |
Una tabla con texto formateado en su interior:
| Left-Aligned | Center Aligned | Right Aligned |
|---|---|---|
| Row 1 | Bold | Cell 3 |
| Row 2 | Italic | Cell 6 |
| Row 3 | Cell 9 | |
| Row 3 | Link | Cell 9 |
Sin embargo, no puede utilizar encabezados, comillas de bloque, listas, delimitadores horizontales, imágenes ni la mayoría de las demás etiquetas HTML dentro de una tabla Markdown.
Sin cabecera
A veces es necesario crear una tabla markdown sin cabecera.
Una tarea tan aparentemente fácil requiere cierta creatividad. Esto se debe a que la mayoría de los analizadores sintácticos de Markdown no admiten tablas sin encabezado. Esto significa que un separador de encabezado es obligatorio.
Para hacer una tabla Markdown sin encabezado, utilice el siguiente truco. Dado que de todos modos se requiere un encabezado, en lugar de texto, ponga simplemente el código especial de comentario HTML <!-- -->:
| |
Como resultado, obtenemos una tabla sin cabecera:
| Row 1 | Bold | Cell 3 |
| Row 2 | Italic | Cell 6 |
| Row 3 | Cell 9 |
Tenga en cuenta que esto funciona en la mayoría de los casos, pero algunas aplicaciones pueden seguir mostrando dicho código de forma incorrecta. En StackOverflow hay una pregunta sobre este tema y respuestas detalladas que describen diferentes opciones para crear dichas tablas.
Fusión
A veces podemos necesitar un formato de tabla aún más sofisticado cuando necesitamos combinar varias celdas de una tabla. Por ejemplo
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| R1 Text | R2 Text A | R3 Text A |
| R3 Text B | ||
| R2 Text B | R3 Text C | |
| R3 Text D |
Permítame decir de entrada que prácticamente ninguna implementación de Markdown puede hacer esto con medios estándar imposible. Porque según la especificación: “si el número de celdas de la tabla es menor que el número de celdas de la fila de cabecera, entonces se insertan celdas en blanco. Si son más, entonces se ignora el exceso”.
Así que la única forma de crear una tabla como la anterior es utilizar código HTML puro. Ejemplo de código para la tabla anterior:
| |
Útil
Outro
Aunque las tablas son una herramienta muy útil para mostrar información en los documentos Markdown, la propia sintaxis del lenguaje sólo permite hacer cosas básicas al crear tablas en los documentos.
Hemos examinado esas funciones básicas y hemos aprendido a crear rápida y fácilmente una tabla en un documento Markdown. Y para casos complicados, siempre nos queda el buen y anticuado código HTML.
Buena suerte.
😎