Saltar al contenido

Diagramas escritos como código

Diagram as Code

Dibuja diagramas de flujo, de secuencia y gráficos de torta de Mermaid mientras escribes, con analizador y trazado propios, dice exactamente qué sintaxis admite y exporta en SVG o PNG.

Texto Mermaid a la izquierda, el dibujo a la derecha, actualizándose mientras escribes. El analizador, la disposición y el renderizador son propios de este sitio y no la biblioteca Mermaid, y por eso la gramática admitida se lista completa en la página: tres tipos de diagrama, y para cada uno exactamente las construcciones que se leen.

🔒 Se ejecuta por completo en tu navegadordiagrammermaidflowchartdocs

Código Mermaid

Vista previa

AlmacénsínoPedido recibido¿Hay stock?CobrarEsperar reposiciónEnviar
Gramática admitida (cualquier otra cosa se informa como error con el número de línea)

Diagrama de flujo — graph / flowchart

  • Direcciones TD, TB, LR, RL, BT
  • Formas [ ], ( ), ([ ]), [[ ]], [( )], (( )), > ], { }, {{ }}
  • Líneas -->, ---, -.->, -.-, ==>, ===
  • Etiquetas -->|texto|, -- texto -->, -. texto .->, == texto ==>
  • A --> B --> C, A & B --> C
  • subgraph nombre [título] … end (se puede anidar)
  • style, classDef, class, :::nombreDeClase
  • %% comentarios, ; separadores

No admitido: click, linkStyle, direction, las flechas <-->, --o y --x, cadenas Markdown

Secuencia — sequenceDiagram

  • participant A as Nombre, actor B
  • ->>, -->>, ->, -->, -x, --x, -), --)
  • ->>+B / ->>-B, activate / deactivate
  • Note left of · right of · over A,B
  • loop, alt / else, opt … end
  • autonumber

No admitido: par, critical, break, rect, box, create/destroy, links

Tarta — pie

  • pie [showData] [title Algo]
  • "nombre" : valor

Los diagramas de clases, de estados, ER, de Gantt, los mapas mentales y los demás tipos todavía no se dibujan. Para los diagramas de Gantt hay una herramienta aparte.

Cómo se usa

  1. Empieza desde un ejemplo

    Diagrama de flujo, de secuencia y de pastel tienen cada uno una muestra que usa casi todo lo que el analizador entiende. Editar una es más rápido que escribir desde la lista de sintaxis.

  2. Lee el error por número de línea

    Cualquier cosa fuera de la gramática admitida se rechaza con la línea y qué estaba mal, en lugar de dejarte un lienzo en blanco para que lo bisecciones.

  3. Exporta o imprime

    El SVG mantiene el texto seleccionable y escala limpiamente; el PNG a 2× es la opción segura para una presentación o un mensaje de chat.

Preguntas frecuentes

¿Qué tipos de diagrama funcionan?

Diagrama de flujo (graph / flowchart), sequenceDiagram y pie. Class, state, ER, gantt, gitGraph, mindmap y el resto se nombran en el error en lugar de fallar vagamente; para un diagrama de Gantt hay una herramienta aparte en este sitio.

Mi diagrama funciona en mermaid.live pero no aquí

Probablemente una construcción fuera de la lista de la página: `click`, `linkStyle`, `direction` dentro de un subgraph, las flechas `<-->`, `--o` y `--x`, front matter YAML, o cadenas Markdown. El error nombra cuál, y la lista es el contrato completo.

¿El texto con tildes, eñes o en coreano se distribuye bien?

Sí. Los anchos de las cajas se miden contando cada carácter CJK a ancho completo y cada letra latina, con tilde o sin ella, a uno, así que una etiqueta en coreano no desborda su nodo como lo hace en renderizadores que suponen que todos los caracteres son de ancho medio. La medida es por punto de código y no normaliza antes, de modo que una «ñ» escrita descompuesta en un Mac (n + tilde combinante) sí cuenta como dos: si una etiqueta sale un poco ancha, pásala antes por el normalizador.

¿Mi diagrama se envía a algún sitio?

No. El análisis y el renderizado ocurren en la página, y el borrador se guarda en este navegador. No se sube nada, lo que importa cuando el diagrama es tu arquitectura interna.

Puede recibir de

Después

Estas aceptan lo que produce esta herramienta, así que el resultado puede pasar directamente.