Cómo crear listas de tareas con Markdown

En este tutorial aprenderás a crear listas de tareas usando Markdown

Las listas de tareas (también conocidas como checklists o listas de verificación) te permiten crear listados con casillas de verificación que puedes marcar o desmarcar. Son especialmente útiles para llevar el seguimiento de pendientes en proyectos, documentar requisitos o crear listas de comprobación.

Al igual que las notas al pie, las listas de tareas forman parte de la sintaxis extendida y no están soportadas por todos los editores. Sin embargo, plataformas como GitHub, GitLab, Obsidian o Joplin sí las soportan.

Crea listas de tareas con Markdown

Para crear una lista de tareas, usa un guion - seguido de un espacio y unos corchetes [ ]. Si quieres marcar una tarea como completada, añade una x dentro de los corchetes [x].

En el siguiente ejemplo creamos una lista de tareas:

- [x] Redactar el borrador
- [x] Revisar la ortografía
- [ ] Publicar el artículo
- [ ] Compartir en redes sociales

El código Markdown anterior debería renderizarse así:

  • ☑ Redactar el borrador
  • ☑ Revisar la ortografía
  • ☐ Publicar el artículo
  • ☐ Compartir en redes sociales

Es importante que dejes un espacio dentro de los corchetes [ ] para las tareas pendientes y una x minúscula [x] para las completadas. Algunos editores también aceptan [X] en mayúscula.

Listas de tareas anidadas

Puedes crear sublistas de tareas indentando los elementos con dos o cuatro espacios. Esto es muy práctico para desglosar tareas complejas en subtareas:

- [ ] Diseñar la página web
    - [x] Crear los wireframes
    - [x] Elegir la paleta de colores
    - [ ] Diseñar los mockups
- [ ] Desarrollar el frontend
    - [x] Configurar el proyecto
    - [ ] Implementar los componentes
    - [ ] Añadir los estilos
- [ ] Realizar las pruebas

El código anterior debería renderizarse como una lista con subtareas donde cada nivel tiene sus propias casillas de verificación.

Combina listas de tareas con formato de texto

Puedes combinar las listas de tareas con negrita, cursiva, enlaces y otros elementos de Markdown para añadir más contexto a cada tarea:

- [x] **Urgente:** Corregir el bug de autenticación
- [x] Revisar el [pull request #42](https://github.com)
- [ ] *Baja prioridad:* Actualizar la documentación
- [ ] ~~Migrar a la nueva API~~ (cancelado)
- [ ] Preparar la demo para el **15 de marzo**

Listas de tareas con contenido adicional

En algunos editores puedes añadir párrafos, bloques de código u otros elementos debajo de cada tarea si los indentas correctamente:

- [ ] Configurar el servidor

  Necesitamos un servidor con al menos 4GB de RAM.

- [x] Instalar las dependencias

  ```bash
  npm install
  • Ejecutar las pruebas

## Ejemplos de uso práctico

Las listas de tareas se utilizan con mucha frecuencia en estos contextos:

**Issues y pull requests en GitHub:**

```md
## Checklist antes de mergear
- [x] Los tests pasan correctamente
- [x] Se ha revisado el código
- [ ] Se ha actualizado la documentación
- [ ] Se ha probado en producción

Gestión de proyectos personales:

## Mudanza
- [x] Contratar la empresa de mudanzas
- [ ] Empaquetar la cocina
- [ ] Cambiar la dirección postal
- [ ] Dar de alta los suministros

Listas de comprobación técnicas:

## Antes de desplegar
- [x] Variables de entorno configuradas
- [x] Base de datos migrada
- [ ] SSL renovado
- [ ] Backups verificados

En GitHub y GitLab, las listas de tareas dentro de los issues muestran además una barra de progreso que indica cuántas tareas se han completado del total.

Y con esto ya hemos terminado. Espero que te haya resultado de ayuda.

👋 Hola! Soy Edu, me encanta crear cosas y he redactado este tutorial. Si te ha resultado útil, el mayor favor que me podrías hacer es el de compatirlo en Twitter.

para estar al día con mi contenido. 😊