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.

Read-only example on the real SlateboxJS canvas.

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 .mmd file, or a .md file 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.
team-map.mmd
---
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"| inner

This 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 linesA flowchart. Shapes become Mermaid’s nearest shapes; labels, arrowheads and dotted, thick or hidden lines are kept. Links on notes stay clickable.
FramesA note drawn behind the notes it holds becomes a subgraph, nested as deep as the frames are.
WorkshopsEach lane becomes a subgraph of its cards, with the lines between them.
Mind mapsA mind map that is one tree comes out as a Mermaid mind map.
Launch plansA Gantt chart when you pick it: each lane becomes a section, and each card’s points become days.
ColoursLeft 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.

  1. Open Mermaid

    In a slate you can edit, choose Mermaid in the slate menu, then Import.

  2. 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.

  3. 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.

mermaid.js
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 }
Terminal
$ slatebox exec mermaid.js
$ curl https://app.slatebox.com/slates/your-share-id.mmd

What is free here.

Free for everyone
Export, import, the public .mmd address 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.
See pricing

Related

Bring a diagram you already have.

Open a blank slate, choose Mermaid in the slate menu and paste it in.