Tablas en Markdown: cómo alinear columnas con dos puntos

Contenido
Seguro que te ha pasado: estás escribiendo una tabla Markdown a mano, quieres centrar el texto y por más que pulsas la barra espaciadora no consigues nada. La alineación de una tabla Markdown no se decide con espacios, sino en un lugar completamente distinto.
Resumen ① La alineación de una tabla Markdown no depende de los espacios dentro de la celda, sino de la posición de los dos puntos (:) en la línea de separación situada justo debajo del encabezado. ②
:---significa alinear a la izquierda,:---:al centro y---:a la derecha: es una convención fija. ③ Si esa línea de separación falta o no tiene el formato correcto, un texto con aspecto de tabla puede no reconocerse como tabla y mostrarse tal cual, como texto normal.
La segunda línea que convierte un texto en tabla
En Markdown, una tabla se compone como mínimo de dos líneas. La primera es la fila de encabezados, con cada celda separada por una barra vertical (|), y la línea inmediatamente siguiente es una línea de separación formada solo por guiones (-). Solo con esa línea de separación el renderizador de Markdown reconoce que aquello es una tabla y trata la línea superior como encabezado.
El problema es que esa línea de separación también se encarga de la información de alineación. A simple vista parece una simple fila de guiones, pero según haya o no dos puntos delante o detrás de los guiones, la alineación de esa columna cambia por completo.
La posición de un solo carácter decide la alineación
En la línea de separación, la posición de los dos puntos determina tres tipos de alineación. :---, con dos puntos solo a la izquierda, alinea a la izquierda; :---:, con dos puntos en ambos extremos, centra; y ---:, con dos puntos solo a la derecha, alinea a la derecha. La forma ---, sin dos puntos, sigue el valor por defecto del renderizador (normalmente a la izquierda).
Por muchos espacios que añadas dentro de la celda para empujar el texto hacia el centro, el resultado renderizado no cambia. El renderizador de Markdown ignora los espacios al principio y al final de la celda y calcula la alineación únicamente a partir de la posición de los dos puntos en la línea de separación.
Generador de tablas Markdown: indica filas, columnas y alineación, y obtén al instante la sintaxis exacta de tu tabla

Qué pasa cuando el formato de la línea de separación no cuadra
Si el número de celdas de la línea de separación no coincide con el de la fila de encabezados, o si se cuela algún carácter que no es un guion, puede que el renderizador de Markdown no reconozca todo el texto como una tabla. En ese caso, las barras verticales y los guiones con los que intentabas dibujar la tabla aparecen como texto y, en lugar de la tabla deseada, solo queda una sucesión de símbolos difícil de leer.
Cómo la herramienta se encarga de esta sintaxis por ti
En el Generador de tablas Markdown indicas el número de filas y columnas y escribes el contenido de cada celda; la herramienta ensambla automáticamente, con la sintaxis correcta, la fila de encabezados, la línea de separación con la información de alineación y las filas del cuerpo. Puedes elegir para cada columna la alineación a la izquierda, al centro o a la derecha, y el cambio se refleja al instante en la posición de los dos puntos de la línea de separación. Aunque incluyas en una celda caracteres que chocan con la sintaxis de la tabla, como una barra vertical (|) o un salto de línea, se escapan automáticamente para que la tabla no se rompa.
En resumen
- La alineación de una tabla Markdown no depende de los espacios dentro de la celda, sino de la posición de los dos puntos en la línea de separación bajo el encabezado.
- Con las tres formas
:---(izquierda),:---:(centro) y---:(derecha) puedes dar a cada columna una alineación distinta. - Si el número de celdas de la línea de separación no coincide con la fila de encabezados o el formato falla, puede que la tabla entera no se reconozca.
- Las barras verticales (|) y los saltos de línea dentro de una celda chocan con la sintaxis de la tabla, así que hay que escaparlos.
- El Generador de tablas Markdown gestiona automáticamente la elección de alineación y el escape de caracteres especiales, y crea tablas con la sintaxis correcta.
Generador de tablas Markdown: indica filas, columnas y alineación, y obtén al instante la sintaxis exacta de tu tabla
Preguntas frecuentes
Si empujo el texto al centro con espacios dentro de la celda, ¿queda centrado?
No. El renderizador de Markdown ignora los espacios al principio y al final de la celda y calcula la alineación solo con la posición de los dos puntos en la línea de separación. Si quieres centrar el texto, tienes que escribir la línea de separación en formato :---:.
¿Qué pasa si no indico la alineación?
Si en la línea de separación solo hay guiones, sin dos puntos (---), no hay información de alineación y se aplica la alineación por defecto del renderizador que muestre la tabla (normalmente a la izquierda).
He puesto barras verticales para que parezca una tabla, pero no se ve como tabla. ¿Por qué?
La causa más habitual es que falte la línea de separación con guiones justo debajo de la fila de encabezados, o que el número de celdas de la línea de separación no coincida con el de la fila de encabezados. Sin línea de separación, el renderizador no la reconoce como tabla y muestra las barras verticales y el texto tal como los escribiste.
¿Cómo puedo incluir una barra vertical (|) dentro de una celda?
La barra vertical es el símbolo que separa las columnas en la sintaxis, así que si la pones tal cual puede interpretarse como una celda nueva. Con esta herramienta, la barra vertical que escribes en una celda se escapa automáticamente para que la tabla no se rompa.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano