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

PublicadoHerramientaGenerador de tablas Markdown

Contenido
  1. La segunda línea que convierte un texto en tabla
  2. La posición de un solo carácter decide la alineación
  3. Qué pasa cuando el formato de la línea de separación no cuadra
  4. Cómo la herramienta se encarga de esta sintaxis por ti
  5. En resumen
  6. Preguntas frecuentes

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

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

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

Artículos relacionados

  1. Convertir una tabla Markdown a CSV para Excel sin erroresPor qué las tablas Markdown de Notion o GitHub se rompen al pegarlas en Excel y cómo pasarlas a CSV sin perder columnas ni caracteres.
  2. Cómo escribir un acta de reunión con acuerdos y tareasUn acta con solo los puntos del día no sirve semanas después. Separa puntos, acuerdos y tareas con responsable y fecha, y genera el acta al instante.
  3. Cómo escribir una nota de prensa: 5W1H en título y primer párrafoTu nota de prensa se descarta si el titular presume en vez de informar. Aprende en qué orden poner las 5W1H en el título y el primer párrafo.
  4. Índice de una propuesta: estructura según el tipo de proyectoPor qué el índice de una propuesta no es libre: estructura estándar según el tipo de proyecto y qué hacer cuando el cliente impone su propio orden.
  5. Convertir SQL INSERT a CSV: distinguir NULL de cadena vacíaConvierte sentencias SQL INSERT en CSV sin perder la diferencia entre NULL y cadena vacía, y comprueba en el resultado que esa distinción se mantiene.
  6. vCard (.vcf): qué es y por qué es compatible entre appsEl .vcf es un estándar de texto abierto y no de una sola empresa: por eso pasa de iPhone a Android sin perder datos. Incluye el escape de comas.

Herramientas relacionadas