Diagramas
Dibuja diagramas de flujo, de secuencia y otros diagramas de Mermaid a partir de texto en un bloque de código.
Actualizado el 19 nov 2026
Escribe un diagrama de Mermaid en un bloque de código con el lenguaje mermaid, y la página publicada lo dibuja. El diagrama vive en tu página como texto, así que se compara y revisa igual que el resto de tu documentación.
flowchart LR
A[Write MDX] --> B[Push to GitHub]
B --> C{Build passes?}
C -->|Yes| D[Site is live]
C -->|No| E[Previous version stays up]```mermaid
flowchart LR
A[Write MDX] --> B[Push to GitHub]
B --> C{Build passes?}
C -->|Yes| D[Site is live]
C -->|No| E[Previous version stays up]
```
Los diagramas siguen el tema claro u oscuro del lector y se vuelven a dibujar cuando este lo cambia.
Tipos de diagramas
Funciona cualquier diagrama que admita Mermaid, por ejemplo:
| Diagrama | Primera línea |
|---|---|
| Diagrama de flujo | flowchart LR o graph TD |
| Diagrama de secuencia | sequenceDiagram |
| Diagrama de clases | classDiagram |
| Diagrama de estados | stateDiagram-v2 |
| Entidad-relación | erDiagram |
| Diagrama de Gantt | gantt |
| Gráfico circular | pie |
sequenceDiagram
participant App
participant API
App->>API: POST /tokens
API-->>App: 201 Created```mermaid
sequenceDiagram
participant App
participant API
App->>API: POST /tokens
API-->>App: 201 Created
```
En pestañas y grupos de código
Un diagrama funciona en cualquier lugar donde funciona un bloque de código, incluso dentro de Pestañas y Grupos de código. En un grupo de código, la etiqueta después de mermaid nombra la pestaña.
<CodeGroup>
```mermaid Flow
flowchart LR
Request --> Response
```
```bash curl
curl https://api.acme.com/health
```
</CodeGroup>
Cuando un diagrama tiene un error
Si Mermaid no puede interpretar un diagrama, la página muestra su código fuente como bloque de código con una nota breve que indica el error, como "Parse error on line 2". El resto de la página no se ve afectado. Corrige el diagrama y vuelve a publicar.
Los lectores sin JavaScript, y las herramientas de IA que leen tu página como Markdown o a través de llms.txt, obtienen el código fuente del diagrama.
Seguridad
Los diagramas se dibujan en el navegador del lector con el nivel de seguridad estricto de Mermaid: las etiquetas no pueden contener scripts, y las acciones de clic en los diagramas están desactivadas.
En el editor visual
Un bloque de Mermaid sigue siendo un bloque de código en el que escribes, con el diagrama dibujado debajo. El dibujo se actualiza un momento después de que dejes de escribir, y muestra el error si el diagrama tiene alguno. Para empezar uno, inserta un Bloque de código y elige Mermaid en el selector de lenguaje.