Cómo crear tablas en Markdown

Las tablas en el editor Markdown te permiten organizar y presentar datos en un formato estructurado y legible — útil para comparar características, opciones de listado o resumir información. Hay dos formas de crear una tabla en el editor Markdown: usando el icono de la barra de herramientas Insertar tabla, o escribiendo manualmente la sintaxis de la tabla Markdown.

Cuándo usar tablas

• Comparaciones de características : muestra las diferencias entre planos, opciones o configuraciones lado a lado.
• Datos de referencia — enumera parámetros, nombres de campos o configuraciones con sus descripciones en un formato estructurado.
• Resúmenes estructurados — presentan conjuntos de datos donde las filas y columnas hacen que las relaciones entre valores sean inmediatamente claras.

Referencia rápida

Sintaxis de la tabla Markdown

| Column 1 | Column 2 | Column 3 |
|:-------- |:--------:| --------:|
| Left     | Center   | Right    |

Alineación de columnas

Límites

Cómo crear una tabla en Markdown

Uso de la barra de herramientas

1. Abre el artículo deseado en el editor Markdown del portal de la Base de Conocimiento.

2. Haz clic en el icono Insertar tabla (⊞) en la barra de herramientas del editor.

   Aparece una cuadrícula interactiva.

3. Arrastra para seleccionar el número de filas y columnas que necesitas. Puedes seleccionar hasta 10 columnas × 15 filas.

4. Para añadir más filas más allá de la selección inicial, muévete a una nueva línea debajo de la tabla e introduce el contenido de la celda usando tuberías verticales (|) para separar cada columna. Cada nueva línea representa una fila.

   Ejemplo:

   | Basic | Yes | Limited | Like    |
   | Pro   | Yes | Full    | Dislike |
   

Escritura manual

1. Abre el artículo deseado en el editor de Markdown.

2. Tipifica pipes verticales (|) y guiones (-) para definir la estructura de la tabla. Usa dos puntos (:) en la fila del separador para establecer la alineación de columnas.

   Código de ejemplo:

   | Column 1 | Column 2 | Column 3 |
   |:-------- |:--------:| --------:|
   | Left     | Center   | Right    |
   

3. Se requiere la fila de separadores (segunda línea). Sin ella, el contenido no se renderizará como una tabla.

Resultado:

Cómo crear una tabla sin una fila de cabecera

El Markdown estándar siempre requiere una fila de cabecera. Si necesitas una tabla sin encabezado visible, usa sintaxis HTML <table> en su lugar:

<table>
  <tr>
    <td>Row 1</td>
    <td>Value 1</td>
  </tr>
  <tr>
    <td>Row 2</td>
    <td>Value 2</td>
  </tr>
</table>

Añade más <tr> bloques por filas adicionales y más <td> celdas dentro de cada fila por columnas adicionales, siguiendo la misma estructura.

Salida:

Mejores prácticas

• Incluye siempre una fila de cabecera — incluso si los nombres de las columnas son genéricos (Columna 1, Columna 2), una fila de cabecera facilita el escaneo de la tabla y es necesaria para la sintaxis estándar de Markdown.
• Mantén el contenido de las celdas conciso — el texto largo en las celdas dificulta la lectura de las tablas. Si una celda necesita más que una frase, considera usar una lista o un párrafo en su lugar.
• Utiliza el alineamiento intencionadamente : alinea a la izquierda las columnas de texto, alinea a la derecha las columnas numéricas y usa el alineamiento central con moderación para etiquetas o valores de estado.
• Usa la barra de herramientas para tablas rápidas — el icono Insertar tabla es la forma más rápida de crear una tabla estándar. Cambia a la sintaxis manual cuando necesites un control preciso sobre la alineación o añadas filas más allá del límite de 15 filas de la barra de herramientas.