Text syntax reference

Every line is one node, arrow, group, or placement.

Nodes

node id "Label" [kind]. Use the id in arrows.

node api "API" [service]
node db "Orders DB" [database]
APIOrders DB

Kinds

Ten kinds, each with its own icon.

service
database
cache
queue
client
user
external
storage
gateway
function

Arrows

-> is one way, <-> is both ways. Put a label after the colon.

node a "Web" [client]
node b "API" [service]
a -> b : "HTTPS"
b <-> a
HTTPSWebAPI

Groups

group id "Label" { a b } draws a boundary around nodes.

node api "API" [service]
node db "DB" [database]
group vpc "VPC" { api db }
VPCAPIDB

Placement

Use right-of, left-of, above, or below. Unplaced nodes take the next free cell.

node api "API" [service]
node db "DB" [database]
node cache "Cache" [cache]
db below api
cache right-of api
APIDBCache

Flow

Add flow at the end of an arrow to animate it.

node a "Client" [client]
node b "API" [service]
a -> b : "request" flow
requestClientAPI

Sequence diagrams

Set type: sequence, then list participants and messages. --> is a reply.

type: sequence
participant c "Client"
participant s "Server"
c -> s : "GET /orders"
s --> c : "200 OK"
GET /orders200 OKClientServer

Themes

Four themes: editorial, minimal, blueprint, mono.

editorial
APIDBCache
minimal
APIDBCache
blueprint
APIDBCache
mono
APIDBCache

Limits

Share links hold up to 6,000 bytes after compression. For larger diagrams, export SVG.

Start drawing — no signup

The editor opens with an example.