Listas en Markdown
Markdown permite crear listas ordenadas, listas no ordenadas, sublistas multinivel y listas de tareas interactivas con una sintaxis limpia y natural.
1. Listas No Ordenadas #
Para crear listas con viñetas (<ul>), puedes utilizar guiones (-), asteriscos (*) o signos más (+) seguidos de un espacio:
1- Elemento de lista con guion 2- Segundo elemento 3* Elemento con asterisco 4+ Elemento con signo más
- Resultado visual:
- Elemento de lista con guion
- Segundo elemento
- Elemento con asterisco
- Elemento con signo más
2. Listas Ordenadas #
Las listas numeradas (<ol>) se construyen con números seguidos de un punto y un espacio (1., 2.):
11. Clonar el repositorio con Git 22. Instalar dependencias con `npm install` 33. Ejecutar servidor de desarrollo con `npm run dev`
- Resultado visual:
- Clonar el repositorio con Git
- Instalar dependencias con
npm install - Ejecutar servidor de desarrollo con
npm run dev
Nota de renderizado: En Markdown estándar, no es necesario que los números sigan un orden numérico estricto en el archivo fuente (por ejemplo, escribir siempre
1.en cada línea); el parser recalculará automáticamente la numeración correlativa al compilar a HTML.
3. Sublistas y Anidamiento #
Para anidar listas dentro de otras, añade una sangría de 2 o 4 espacios (o un tabulador) antes del marcador:
11. Fase de Análisis 2 - Entrevistas con stakeholders 3 - Redacción de historias de usuario 42. Fase de Desarrollo 5 1. Configuración de base de datos 6 2. Implementación de endpoints REST
- Resultado visual:
- Fase de Análisis
- Entrevistas con stakeholders
- Redacción de historias de usuario
- Fase de Desarrollo
- Configuración de base de datos
- Implementación de endpoints REST
4. Listas de Tareas (GFM - Checklists) #
La extensión GitHub Flavored Markdown (GFM) incorpora casillas de verificación interactivas para gestión de tareas:
- [ ]: Tarea pendiente (casilla desmarcada).- [x]: Tarea completada (casilla marcada).
1### Estado de la Release 2- [x] Corrección de bugs críticos 3- [x] Cobertura de tests unitarios al 85% 4- [ ] Despliegue en entorno de producción
- Resultado visual:
Estado de la Release #
- Corrección de bugs críticos
- Cobertura de tests unitarios al 85%
- Despliegue en entorno de producción
Resumen del tema
Conceptos clave #
- Listas No Ordenadas: marcadores
-,*o+seguidos de un espacio (<ul>). - Listas Ordenadas: dígitos numéricos con punto
1.,2.(<ol>) recalculados automáticamente por el renderizador. - Anidamiento y Sangría: 2 o 4 espacios (o tabulación) antes del marcador del sub-elemento para crear jerarquías anidadas.
- Listas de Tareas (GFM): casillas de verificación interactivas
- [x](completada) y- [ ](pendiente).
Qué debes recordar #
Usa sangría consistente (2 o 4 espacios) para anidar sublistas y la sintaxis GFM - [x] / - [ ] para gestionar tareas pendientes.