File format

.canvas.md

An infinite whiteboard as a Markdown file. Paste the spec to your AI and it writes the board for you.

launch.canvas.mdplain text · git-diffable
1## @canvas main
2
3canvas:
4 background: dots
5 nodes:
6 - id: idea
7 type: sticky
8 x: 60 y: 60
9 text: "Ship v1.1"
10 color: yellow
11 - id: flow
12 type: card
13 title: "Release flow"
14 - id: gate
15 type: diamond
16 text: "QA pass?"
17 edges:
18 - { from: idea, to: flow, style: elbow }
19 - { from: flow, to: gate }
drives
Ship v1.1
Release flow
Build → sign → notarise
QA pass?

Using it

Let your AI draw the board.

The spec is one paste away — describe what you want mapped and Arg0 renders the reply.

1

Paste the spec

Copy the format reference into ChatGPT or Claude.

2

Describe the board

"Sketch our launch plan" — it writes a .canvas.md.

3

Save the reply

Drop the file into any folder Arg0 can see.

4

It draws itself

Nodes, edges and stickies land on the canvas.

ChatGPT
Claude
@canvas
01

Place nodes as YAML

An @canvas block: a background, a list of positioned nodes, and edges between them.

02

Arg0 draws the board

Stickies, cards, sixteen diagram shapes, images, frames — rendered on an infinite canvas.

03

Edit either side

Drag on the canvas or edit the text. Both write the same file.

Node palette

One type field, twenty-four shapes.

Change type: and the node becomes it — from a sticky note to a database cylinder to freehand ink.

cardstickytextrectpillellipsediamondparallelogramtrapezoidtrianglehexagoncylinderactorannotationlinebracketcloudstarimagefilelinkframegroupink

A whiteboard in a file

Every node is a positioned list item, every edge a from/to pair. Review a board change in a pull request.

Real edges

Labels, elbow routing, arrow heads and side anchors — written inline as { from: a, to: b, style: elbow }.

Frames and groups

Frame nodes embed a mini design surface; group containment serialises straight into the YAML.

Same file, every device

Desktop, web and mobile share one parser — the board you draw on your Mac opens identically on your phone.

Sketch it in text. Keep it forever.

No canvas lock-in, no binary board files. The drawing is the diff.