Diagramas Gantt Mermaid para planes de proyecto ligeros

Los diagramas Gantt de Mermaid son útiles cuando el plan pertenece al mismo repositorio que las notas de implementación. Su código es revisable y versionado, adecuado para lanzamientos, migraciones y proyectos documentales con pocas tareas.

Define fechas e ID de tareas explícitamente

gantt
  title Publicación de documentación
  dateFormat YYYY-MM-DD
  axisFormat %b %d
  section Investigación
  Auditar páginas :done, audit, 2026-07-11, 3d
  Elegir temas     :topics, after audit, 2d
  section Entrega
  Redactar guías   :active, draft, after topics, 6d
  Revisión técnica :review, after draft, 2d
  Publicar         :milestone, publish, after review, 0d

Los ID como audit y draft son objetivos estables para dependencias. Las etiquetas pueden cambiar sin romper after. Define dateFormat antes de usar fechas literales.

Usa marcadores de estado con moderación

done, active, crit y milestone resaltan estados, pero si todo es crítico la señal desaparece. Un hito no tiene duración: representa una decisión o entrega, no varios días de trabajo.

Trata las dependencias como comunicación

after draft expresa una dependencia fin-inicio. La planificación real puede requerir capacidad, calendarios laborables y progreso parcial. Mermaid no es un motor completo de gestión de proyectos; no sugieras una precisión que el modelo no contiene. Para compromisos contractuales, usa el sistema oficial y enlaza una vista simplificada.

Mantén el plan revisable

Agrupa tareas en secciones, usa etiquetas cortas y actualiza fechas en el mismo pull request que cambia el compromiso. Si supera una pantalla, separa una hoja de ruta de fases e hitos y un plan detallado de la fase actual.

Abre la plantilla Gantt en el editor Mermaid local para validar y exportar SVG o PNG.