Skip to main content
Whiteboards are freeform diagrams stored as markdown files with an .excalidraw.md suffix. KiwiFS embeds Excalidraw scene data inside the file so drawings version with the rest of your knowledge base.

​
File location

New whiteboards are created under whiteboards/ by default: 
whiteboards/brainstorm.excalidraw.md
whiteboards/architecture.excalidraw.md
Each file uses YAML frontmatter and a fenced JSON block that Excalidraw can parse. The drawing data lives in a ```json fence under ## Drawing.

​
Web UI

1

Open the whiteboard hub

Click Whiteboard in the toolbar. The hub lists all .excalidraw.md files in your knowledge base.
2

Create or select a board

Use New whiteboard to create a file under whiteboards/, or pick an existing board from the dropdown.
3

Draw and save

Use Excalidraw tools to sketch, annotate, and connect shapes. Changes save automatically to the markdown file on disk.
You can also open a whiteboard from the file tree like any other page. Excalidraw markdown renders inline in page view.
Whiteboards are plain markdown files. Agents can read and write them with kiwi_read and kiwi_write like any other page — no separate API is required.

Web UI

Toolbar views and file tree.

Canvas

Structured JSON canvas diagrams.

Files as truth

How KiwiFS stores everything on disk.
Last modified on May 23, 2026