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
mermaidy 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
flowchartsolo se admitenTB,TD,BT,RLoLR. - 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.