Mermaid
Every slate is a Mermaid diagram.
Export any slate as Mermaid text for a README, a doc or a pull request. Paste Mermaid back in and it becomes real notes and lines you can move, restyle and present. Free on every slate.
The button opens a blank private slate. Mermaid is in its slate menu. It needs no AI and no renderer: the text is written straight from the slate.
Team A [platform] holds API, Sticker over the team and the Inner squad frame with Gateway. API to Gateway; Gateway to Billing, labelled calls; Billing to Inner squad, labelled reports to.
Export
The same slate, as Mermaid.
This is the text Slatebox writes for the slate above, word for word. A frame drawn behind its notes becomes a subgraph, line labels stay on their lines, and the direction comes from the way the lines run.
- Copy
- Copy the Mermaid, or copy it already inside a Markdown code block.
- Download
- Save a
.mmdfile, or a.mdfile with the block in it. - Link
- A public slate also has a plain-text address,
/slates/<id>.mmd, that always shows the slate as it is now.
---
title: "Team map"
---
flowchart TD
subgraph teamA["Team A [platform]"]
on-top["Sticker over the team"]
a1["API"]
subgraph inner["Inner squad"]
a2["Gateway"]
end
end
b1["Billing"]
a1 --> a2
a2 -->|"calls"| b1
b1 -->|"reports to"| innerThis file is one of the app’s test fixtures. Its tests export this team map, compare the result with the file, and read the file with Mermaid’s own parser.
What carries over
Notes, lines and frames, in Mermaid’s own words.
Slatebox picks the kind of diagram that reads best. You can choose another in the Format list.
| Notes and lines | A flowchart. Shapes become Mermaid’s nearest shapes; labels, arrowheads and dotted, thick or hidden lines are kept. Links on notes stay clickable. |
|---|---|
| Frames | A note drawn behind the notes it holds becomes a subgraph, nested as deep as the frames are. |
| Workshops | Each lane becomes a subgraph of its cards, with the lines between them. |
| Mind maps | A mind map that is one tree comes out as a Mermaid mind map. |
| Launch plans | A Gantt chart when you pick it: each lane becomes a section, and each card’s points become days. |
| Colours | Left out unless you turn on Include colours. |
What Mermaid has no word for is named when you export, never dropped quietly: Mermaid has one broken-line style, so a dashed line is written as dotted.
Import
Paste Mermaid, get a slate.
Open Mermaid
In a slate you can edit, choose Mermaid in the slate menu, then Import.
Paste or open a file
Paste a flowchart, a mind map or a Gantt chart, or a Markdown file with a Mermaid block. It says what it found before anything is added.
Keep it
Choose Add to this slate or Open as a new slate. Subgraphs and Gantt sections arrive as frames, laid out in the diagram’s direction.
Other kinds of Mermaid, such as sequence diagrams, are refused by name and nothing is added. A mistake names its line. One import holds up to 1,000 notes.
Agents
Agents read and write Mermaid through exec.
The same two calls are in the typed client every exec script gets, on the hosted MCP endpoint, the slatebox command and the HTTP API. A script can pull a slate into a README, or draw a diagram it wrote.
A public slate needs no token at all: its address ends in .mmd.
const { mermaid, warnings } = await slatebox.slates.exportMermaid({
shareId: "your-share-id",
})
const drawn = await slatebox.slates.importMermaid({
mermaid: "flowchart LR\n idea --> plan --> ship",
name: "From the README",
})
return { mermaid, warnings, url: drawn.url }$ slatebox exec mermaid.js
$ curl https://app.slatebox.com/slates/your-share-id.mmdWhat is free here.
- Free for everyone
- Export, import, the public
.mmdaddress and the two exec calls, on Slatebox Cloud and on your own server. A guest registers first, as for any export. - Free amount each month
- Nothing here uses it. Mermaid needs no AI.
Related
Draw it here, then take it anywhere.
Bring a diagram you already have.
Open a blank slate, choose Mermaid in the slate menu and paste it in.