Cómo gestionar proyectos con Markdown y diagramas de Gantt de Mermaid

Gestiona proyectos con Markdown y Gantt de Mermaid

Las herramientas de gestión de proyectos son cómodas, pero tienen una cuota mensual, tus datos quedan encerrados en el servicio y nadie sabe si ese servicio seguirá existiendo dentro de unos años.

Los archivos de texto, en cambio, se seguirán abriendo dentro de 30 años. En este artículo te enseñamos a seguir el avance de tus proyectos solo con Markdown y Mermaid.

Por qué gestionar proyectos en texto plano

  • Se abre en cualquier editor. No dependes de ninguna app concreta
  • Puedes ver las diferencias. Guárdalo en Git y tendrás un registro de quién cambió qué y cuándo
  • Se puede buscar. Con el Finder o con grep: funciona como cualquier archivo normal
  • Es fácil pasárselo a la IA. Hoy en día, esta es la mayor ventaja de todas (más sobre esto abajo)

Cómo escribir un diagrama de Gantt en Mermaid

Mermaid es una sintaxis para dibujar diagramas con texto. Se escribe en un bloque de código de Markdown marcado como mermaid.

```mermaid
gantt
title Renovación de la web
dateFormat YYYY-MM-DD
axisFormat %m/%d
excludes weekends

section Preparación
Reunir requisitos :done, req, 2026-09-01, 5d
Definir el diseño :done, des, after req, 4d

section Desarrollo
Crear la portada :active, top, 2026-09-12, 7d
Crear páginas internas : sub, after top, 10d

section Lanzamiento
Revisión interna :crit, rev, after sub, 3d
Publicación :milestone, m1, after rev, 0d
```

No hay mucho que memorizar.

SintaxisSignificado
dateFormat YYYY-MM-DDFormato de fecha (decláralo primero)
section NombreAgrupa las tareas en fases
:done,Tarea terminada (gris)
:active,Tarea en curso (color más oscuro)
:crit,Tarea crítica (rojo)
:milestone,Marca en forma de rombo para una fecha límite
after reqEmpieza cuando termina otra tarea (ID req)
5d / 2wDuración (días, semanas)
excludes weekendsDeja los sábados y domingos fuera del recuento de días

Errores habituales

  • Si olvidas dateFormat, las fechas no se interpretan
  • Un : dentro del nombre de una tarea provoca un error
  • after hace referencia al ID, no al nombre de la tarea (req, top, etc. en el ejemplo anterior)

Una rutina sencilla para seguir el avance

Las rutinas complicadas no duran. Estos tres hábitos son todo lo que necesitas.

  1. Crea una nota de resumen por proyecto. El objetivo, las personas implicadas, en qué punto está, qué viene después y el diagrama de Gantt
  2. Actualízala solo una vez a la semana. Cambia :active por :done y corrige las fechas de las tareas que se han retrasado. Son cinco minutos
  3. Escribe las tareas pequeñas como listas de comprobación. Escríbelas así: - [ ] Enviar el borrador, y verás de un vistazo lo que queda pendiente

El diagrama de Gantt sirve para ver la forma general; la gestión de tareas del día a día es cosa de la lista de comprobación. Poder tener ambas cosas en un solo archivo es lo que hace que este método funcione.

Dónde ver los diagramas

Mermaid se muestra tal cual en el Markdown de GitHub y GitLab. Si quieres verlo mientras escribes en tu propio Mac, necesitas un editor compatible con Mermaid.

  • Markdocx lleva Mermaid integrado y lo representa todo en tu Mac. Con una sola app llegas hasta exportar el documento terminado en Word o PDF
  • Orviss incluye de serie un diagrama de Gantt en su plantilla «Resumen del proyecto». Solo tienes que añadir líneas para empezar a seguir el avance

Deja que lo lea un agente de IA

Aquí es donde gestionar en texto sale realmente a cuenta.

Los agentes de IA como Claude Code, Codex y Cursor pueden leer y escribir los archivos de una carpeta. Si los materiales de tu proyecto son Markdown normal en tu disco local, basta con indicarle al agente esa carpeta, y peticiones como estas

  • «Resume en cinco líneas en qué punto está este proyecto»
  • «Saca las tareas pendientes de las notas de la reunión de la semana pasada y añádelas a la lista de comprobación»
  • «Vamos tres días tarde, así que rehaz las fechas del diagrama de Gantt»

funcionan sin más. Sin configurar integraciones especiales ni claves de API. Tu carpeta de proyecto se convierte directamente en el cerebro externo de la IA.

Orviss es una app creada pensando en esta forma de trabajar. En las carpetas de proyecto y de fecha puedes guardar juntos no solo notas en Markdown, sino también archivos normales, páginas web y correos. Todo son archivos locales normales, así que los cambios que hace el agente aparecen en pantalla al momento. La versión para Mac ya está disponible, y las versiones para iPhone y iPad llegarán pronto.

→ Más información sobre Orviss

Resumen

  • El gantt de Mermaid es una sintaxis sencilla con menos de 10 cosas que memorizar
  • Una nota de resumen y una actualización semanal bastan para mantener el seguimiento del avance
  • Tenerlo todo en texto te permite pasárselo directamente a un agente de IA como contexto

Más sobre Orviss