excalidrawlisted

# Excalidraw board generator (Obsidian) Write `.excalidraw.md` files that render natively in this vault's Obsidian Excalidraw plugin. **Do not hand-author the scene JSON.** Build a small spec and run the generator — it produces the frontmatter, `## Text Elements`, `## Embedded Files`, and the `%% ## Drawing … %%` JSON, with correct sha1 image links, fractional z-indices, and deterministic seeds (clean git diffs). ## Design principles (read first) Excalidraw's strength is **pictures, not paragraphs**. Four rules keep a board clean, readable, and visually rich — the primitives below enforce them, so lean on them instead of placing raw text/shapes: 1. **Use a primitive; don't hand-roll one.** There are ~44 ready builders (charts, house style, devices/UI) covering most of what a board needs — pass DATA, get correct geometry. This is the rule the other three depend on: hand-rolled composites are where boards break. Reach for `charts.js` / `wireframe.js` / `style.js` **before** writing rects + text yourself, and only drop to raw elements when nothing fits. Every builder is also a spec JSON `type`, so a whole board can be pure JSON. 2. **Visual-first.** Explain complex things with *structure you can see*: a `funnel()` of trapezoid bands, a `device()` of the actual screen, a `lineChart()` of the trend, a `hub()`/flow of `card()`s. Reach for a picture before a sentence. When you must write, keep it to labels and short notes. 3. **Readable measure — text never run