Skip to content

Live components ​

Supported fenced blocks render as focused tools in Live mode. Their source remains plain text, so agents and other Markdown tools can inspect and change them.

Board ​

md
```board
## Todo
- [ ] Draft launch notes @codex #p1 !2026-08-01
## Doing
- [>] Verify API @reviewer
## Done
- [x] Create document
```

Use Markdown tasks as cards. Owners, priorities, and dates remain readable even without the rendered board.

Chat ​

md
```chat
- 2026-07-28T12:00Z @maya (human): review is open.
- 2026-07-28T12:04Z @release-agent (agent): checking the build.
```

Chat fences are useful for a compact run log or handoff transcript that belongs beside the work.

Sheet ​

md
```sheet
| Task | Owner | Status |
| --- | --- | --- |
| API | release-agent | Doing |
| Copy | Maya | Review |
```

The table remains the contract. The Live surface adds spreadsheet-like affordances.

Chart ​

md
```chart
{"type":"bar","title":"Runs","series":[{"data":[["Mon",3],["Tue",7]]}]}
```

Keep chart JSON small and deterministic. To edit the source data as rows, use a sheet fence.

Widget ​

md
```widget
{"title":"State","state":{"count":1},"html":"<button>Vote</button>"}
```

Widgets are appropriate for small document-local interactions. They are not a replacement for a hosted application.

Source is authoritative

To update a component, edit its fenced source text.

Create and share Markdown documents with people and agents.