Share an Excalidraw drawing

Excalidraw is where the system design actually happens: boxes, arrows, the hand-drawn look that signals this is a sketch, argue with it.

Then the sketch becomes the decision, and the way you share it matters more than it did an hour ago.

The share link is a room, not a document

Share → Live collaboration gives you a URL, and it is genuinely useful while three people are drawing together. It is the wrong thing to paste into an architecture decision record, because:

  • Anyone holding the link can move, delete or redraw anything.
  • The drawing keeps changing after the approval, silently.
  • There is no version of it that anyone agreed to.

A design that someone signs off on should stop being editable by everyone who saw it.

Export to SVG, with the scene embedded

File → Export image…, choose SVG, and tick Embed scene.

That gives you one file that is simultaneously a crisp read-only picture and a re-openable Excalidraw document. You keep the ability to edit; the reader gets something fixed.

Skip PNG. Excalidraw's whole aesthetic is strokes and hand-drawn text, and those are exactly what rasterization ruins — see stop screenshotting reports.

Publish the SVG as a page

Wrap it and publish:

<!doctype html>
<meta charset="utf-8" />
<title>Ingest pipeline — proposed</title>
<article>
  <h1>Ingest pipeline — proposed</h1>
  <p>Replaces the Kinesis hop with a direct write. Open questions marked in red.</p>
  <!-- exported SVG, inlined -->
</article>

The prose above the drawing is worth the thirty seconds. A sketch with no caption gets interpreted differently by every reader; a sketch with two sentences of intent gets argued with on the merits.

Review that survives the next edit

Feedback on a live Excalidraw room disappears into the room. Feedback on a published page is a thread anchored to the drawing, and it stays attached when you publish a revision to the same URL — so the reason the arrow moved is recorded next to the arrow. See commenting on HTML.

Worth knowing

  • Embed scene, always. An SVG without it is a dead end; the next change means redrawing from scratch.
  • Dark-mode exports look wrong on light pages. Export in the theme the reader will see, or set an explicit background.
  • Excalidraw+ and self-hosted rooms need accounts. A published page needs none, which matters when the reviewer is outside your org.
  • 5 MB per report body.

Try it

Free — unlimited reports, commenters and revisions.

Publish a drawing →

Related