Skip to content
Mintlify
Mintlify
Formato

Listas y tablas

Da formato a datos estructurados con tablas en Markdown, listas ordenadas y no ordenadas, estructuras anidadas y casillas de tareas.

Las listas siguen la sintaxis oficial de Markdown.

Para crear una lista ordenada, agrega números seguidos de un punto antes de cada elemento.

  1. Primer elemento
  2. Segundo elemento
  3. Tercer elemento
  4. Cuarto elemento
1. Primer elemento
2. Segundo elemento
3. Tercer elemento
4. Cuarto elemento

Para crear una lista sin orden, agrega guiones (-), asteriscos (*) o signos más (+) antes de los elementos de la lista.

  • Primer elemento
  • Segundo elemento
  • Tercer elemento
  • Cuarto elemento
- Primer elemento
- Segundo elemento
- Tercer elemento
- Cuarto elemento

Sangra los elementos de la lista para anidarlos.

  • Primer elemento
  • Segundo elemento
    • Elemento adicional
    • Elemento adicional
  • Tercer elemento
- Primer elemento
- Segundo elemento
  - Elemento adicional
  - Elemento adicional
- Tercer elemento

Para crear una lista de tareas, agrega [ ] para una casilla sin marcar o [x] para una casilla marcada después de los marcadores de lista sin orden.

  • Elemento completado
  • Elemento incompleto
- [x] Elemento completado
- [ ] Elemento incompleto

Las tablas siguen la sintaxis oficial de Markdown.

Para añadir una tabla, usa tres o más guiones (---) para crear el encabezado de cada columna y usa barras verticales (|) para separar cada columna. Por compatibilidad, también debes añadir una barra vertical al principio y al final de cada fila.

PropiedadDescripción
NombreNombre completo del usuario
EdadEdad indicada
IngresoSi el usuario se unió a la comunidad
| Property | Descripción                           |
| -------- | ------------------------------------- |
| Name     | Nombre completo del usuario           |
| Age      | Edad reportada                        |
| Joined   | Si el usuario se unió a la comunidad  |

Para incluir un carácter de barra vertical literal (|) en una celda de tabla, antepón una barra invertida (\|). Escapa los caracteres de barra vertical incluso cuando aparezcan dentro de código en línea. De lo contrario, la barra vertical se interpreta como un separador de columnas y puede causar errores de análisis durante la vista previa o la validación.

ValorDescripción
read|writeUn valor que contiene una barra vertical literal
| Value         | Description                       |
| ------------- | --------------------------------- |
| `read\|write` | A value containing a literal pipe |

Usa dos puntos en la fila de separación para alinear el contenido de las columnas:

Alineado a la izquierdaAlineado al centroAlineado a la derecha
IzquierdaCentroDerecha
TextoTextoTexto
| Alineado a la izquierda | Alineado al centro | Alineado a la derecha |
| :----------- | :------------: | ------------: |
| Izquierda         | Centro         | Derecha         |
| Texto         | Texto           | Texto          |

Las tablas de Markdown ajustan el ancho de sus columnas automáticamente según el contenido. Para controlar el ancho de las columnas, escribe la tabla en HTML y agrega un elemento <colgroup> que defina un ancho en cada <col>.

En el modo visual del editor, arrastra el borde de una columna para cambiar su ancho. El editor convierte la tabla a HTML y escribe los anchos del <colgroup> por ti.

Cuando cada <col> declara un ancho, mediante el atributo width o un estilo en línea, la tabla usa tus anchos y ajusta el contenido largo dentro de cada columna. Si a algún <col> le falta el ancho, Mintlify ignora los anchos declarados y ajusta las columnas según el contenido. Las tablas demasiado anchas para la página siguen desplazándose horizontalmente.

ParámetroTipoDescripción
namestringNombre completo del usuario
agenumberEdad reportada del usuario
<table>
  <colgroup>
    <col width="25%" />
    <col width="15%" />
    <col width="60%" />
  </colgroup>
  <thead>
    <tr>
      <th>Parameter</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Full name of the user</td>
    </tr>
    <tr>
      <td>age</td>
      <td>number</td>
      <td>Reported age of the user</td>
    </tr>
  </tbody>
</table>
Was this page helpful?Suggest editsRaise issue