como-usar-listas-en-markdown

Cómo usar listas en Markdown

Las listas son una enumeración elementos, y son una herramienta fundamental para estructurar y organizar información en documentos Markdown.

Las listas pueden ser desordenadas o ordenadas. En las primeras, (adivinad!) el orden de los elementos no importa, mientras que en el segundo sí tienen orden.

Normalmente, la impresión general es que las segundas “tienen numeración”. Pero no es así, eso es la forma de representar la lista. Una lista ordenada puede no estar numerada.

Listas desordenadas

Las listas desordenadas se utilizan para enumerar elementos sin un orden específico. En Markdown, puedes crear listas desordenadas utilizando asteriscos (*), guiones (-), o signos más (+) al comienzo de cada elemento de la lista.

Sintaxis

Para crear una lista desordenada, simplemente coloca un asterisco, guion o signo más seguido de un espacio y el texto del elemento.

* Elemento 1
* Elemento 2
* Elemento 3
- Elemento 1
- Elemento 2
- Elemento 3
+ Elemento 1
+ Elemento 2
+ Elemento 3

Todas las opciones anteriores se renderizan de la misma manera:

  • Elemento 1
  • Elemento 2
  • Elemento 3

Anidación de Listas Desordenadas

Puedes crear listas anidadas simplemente añadiendo cuatro espacios o un tabulador antes de los elementos de la sublista.

* Elemento 1
    * Sub-elemento 1
    * Sub-elemento 2
* Elemento 2
    - Sub-elemento 1
    - Sub-elemento 2
* Elemento 3

Esto se renderiza como:

  • Elemento 1
    • Sub-elemento 1
    • Sub-elemento 2
  • Elemento 2
    • Sub-elemento 1
    • Sub-elemento 2
  • Elemento 3

Listas Ordenadas

Las listas ordenadas son ideales para enumerar elementos que siguen un orden específico. En Markdown, puedes crear listas ordenadas utilizando números seguidos de un punto y un espacio.

Sintaxis

Para crear una lista ordenada, simplemente coloca un número seguido de un punto y un espacio antes del texto del elemento. El número que uses no importa, ya que Markdown ajustará automáticamente el orden al renderizar.

1. Elemento 1
2. Elemento 2
3. Elemento 3

Esto se renderiza como:

  1. Elemento 1
  2. Elemento 2
  3. Elemento 3

Anidación de listas ordenadas

Al igual que con las listas desordenadas, podemos crear listas ordenadas anidadas añadiendo cuatro espacios o un tabulador antes de los elementos de la sublista.

1. Elemento 1
    1. Sub-elemento 1
    2. Sub-elemento 2
2. Elemento 2
    1. Sub-elemento 1
    2. Sub-elemento 2
3. Elemento 3

Esto se renderiza como:

  1. Elemento 1
    1. Sub-elemento 1
    2. Sub-elemento 2
  2. Elemento 2
    1. Sub-elemento 1
    2. Sub-elemento 2
  3. Elemento 3

Listas Mixtas

También podemos combinar listas desordenadas y ordenadas en el mismo documento para montar un lio que no entienda nadie estructurar la información de manera más efectiva.

1. Paso 1
    - Detalle 1
    - Detalle 2
2. Paso 2
    - Detalle 1
        1. Sub-paso 1
        2. Sub-paso 2
    - Detalle 2
3. Paso 3

Esto se renderiza como:

  1. Paso 1
    • Detalle 1
    • Detalle 2
  2. Paso 2
    • Detalle 1
      1. Sub-paso 1
      2. Sub-paso 2
    • Detalle 2
  3. Paso 3

Eeeh, en serio… no hagáis eso. Os va a funcionar, pero no lo hagáis 😉.

Buenas prácticas Consejos

Consistencia en la sintaxis: Utiliza un solo estilo de lista desordenada (asteriscos, guiones o signos más) para mantener la consistencia en todo el documento.

Claridad y Organización: Usa listas para mejorar la claridad y organización de la información, especialmente cuando enumeras pasos, elementos o detalles relacionados.

Uso Adecuado del Tipo de Lista: Utiliza listas ordenadas para pasos secuenciales y listas desordenadas para elementos no secuenciales.

Simplicidad en la Anidación: No anides demasiados niveles de listas para evitar confusión y mejorar la legibilidad.