Tutorial de Mermaid: diagramas de flujo, de secuencia y de Gantt

Mermaid te permite describir un diagrama con texto. No hay cajas que arrastrar ni imágenes que mantener: escribe unas líneas en tu Markdown y el visor dibuja el diagrama. Los diagramas de texto son fáciles de editar, encajan perfectamente con el control de versiones y funcionan en GitHub, GitLab, Notion y Moread.

Cómo añadir Mermaid a Markdown

Abre un bloque de código con tres comillas invertidas e indica el lenguaje mermaid:

```mermaid
flowchart LR
    A[Inicio] --> B[Fin]
```

Guárdalo en un archivo .md, ábrelo en Moread y verás un diagrama de flujo de izquierda a derecha. Pulsa Ampliar en el diagrama para hacer zoom.

Diagramas de flujo

La primera línea define la dirección: TD (de arriba abajo) o LR (de izquierda a derecha). El tipo de paréntesis define la forma del nodo:

flowchart TD
    A[Rectángulo] --> B(Redondeado)
    B --> C{Decisión}
    C -->|Sí| D[[Subproceso]]
    C -->|No| E((Círculo))
  • --> es una flecha, --- una línea simple y -.-> una flecha punteada.
  • |texto| etiqueta una flecha, normalmente con una condición.
  • Los ID de los nodos (A, B, C) solo tienen que ser únicos; lo que se muestra es el texto entre paréntesis.

Diagramas de secuencia

Ideales para mostrar cómo interactúan usuarios y sistemas a lo largo del tiempo:

sequenceDiagram
    participant U as Usuario
    participant S as Servidor
    U->>S: Enviar inicio de sesión
    S-->>U: Devolver resultado
    Note over U,S: Todo el tráfico usa HTTPS

->> es una flecha continua (petición) y -->> una flecha discontinua (respuesta). Usa Note over para añadir notas.

Diagramas de Gantt

El calendario de un proyecto de un vistazo:

gantt
    title Rediseño del sitio web
    dateFormat YYYY-MM-DD
    section Diseño
    Entrevistas :a1, 2025-01-06, 5d
    Diseño de interfaz :after a1, 7d
    section Desarrollo
    Front end :2025-01-20, 10d
    Pruebas y lanzamiento :5d

Gráficos circulares

pie title Un día típico
    "Trabajo" : 8
    "Sueño" : 7
    "Lectura" : 2
    "Otros" : 7

Diagramas de estados

stateDiagram-v2
    [*] --> Borrador
    Borrador --> Revision: Enviar
    Revision --> Publicado: Aprobar
    Revision --> Borrador: Rechazar
    Publicado --> [*]

Solución de problemas

  • El diagrama no aparece: comprueba que el bloque de código tenga el lenguaje mermaid y que la primera línea indique el tipo de diagrama (flowchart, sequenceDiagram, etc.).
  • Caracteres especiales en las etiquetas: pon entre comillas dobles las etiquetas con paréntesis o dos puntos, por ejemplo A["Precio (IVA incl.)"].
  • Dirección incorrecta: después de flowchart solo se admiten TB, TD, BT, RL o LR.
  • Si un diagrama tiene un error, Moread conserva el código, muestra el motivo y presenta el resto del documento con normalidad.

Consejos

  • Los diagramas grandes suelen leerse mejor con la dirección LR.
  • Un documento puede tener muchos diagramas; Moread dibuja hasta 40 por archivo.
  • Los diagramas se adaptan al tema oscuro, y al exportar a PDF cambian a colores claros aptos para imprimir.

¿Quieres verlo en acción? En la página de inicio de Moread, pulsa Demo: diagramas · fórmulas · código para abrir un documento de ejemplo con diagramas Mermaid.