Blog · guide

Publish a diagram as a page, embed it anywhere, and keep every version

How Diagramly Pro publishes a diagram to its own public page, embeds it live in Notion or a blog, and keeps a version history you can restore from.

13 October 20263 min readguidepropublishing

A diagram that lives inside a tool is only useful to people who open the tool. These three features are about getting it out: as a page people can find, as a live embed in the docs you already write, and with a history so nothing you drew is ever lost.

Publish: a page of its own

Open Share → Publish, give it a title and a sentence of description, and press Publish.

The Share sheet's Publish tab with a title and description field — The publish form. The description shows on the page and in search results.

A few seconds later you have a page at diagramly.xyz/d/your-title-xxxxxx.

The Share sheet after publishing, showing the live link and an Update button — Once it's live, the sheet shows the link, and an Update button for when you change the diagram.

The page is rendered on the server, so search engines read it properly: the title, the description, the words in the diagram, and structured data describing it. Paste the link into Slack, X or LinkedIn and it unfurls with a picture of the diagram.

A published diagram page with Present, Copy link, Embed and Make a copy buttons — What visitors see. They can pan, zoom, present it, or open their own copy.

Publishing takes a snapshot. Keep editing and the page stays as it was until you press Update published page; the sheet tells you when the canvas has drifted from what's live. Unpublish takes it down straight away.

Embed: the diagram inside your docs

Share → Embed gives you an iframe snippet for Notion, Confluence, Ghost, WordPress, or anything that takes HTML. Pick a height, choose whether to show a caption link under it, paste.

The Share sheet's Embed tab with a live preview and the snippet — The embed tab shows a live preview and the code to paste.

The embed is live: readers pan, zoom and press Present inside your page. If the diagram is published, the embed shows the published version and updates with it. If it isn't, the diagram travels inside the embed URL and shows that version.

Version history: every state, kept

With Pro, a snapshot is saved when an editing session starts and then every ten minutes while you work. The clock icon in the header opens them, grouped by day.

The Version history sheet with a named version and an autosave, and a preview of the selected one — Name the versions that matter. The automatic ones are pruned after forty.

Pick a version and you see a preview, when it was saved, and how it compares to the canvas. Restore puts it back as one undoable step, and the state you're leaving is kept as a version first, so nothing is lost in either direction. ↑ and ↓ walk the list; Enter restores.

And your profile

Everything you've saved is on your profile, with folders, tags and search. It also shows your streak: a heatmap of the days you drew something. I didn't expect that to be motivating. It is.

Streaks, a year of activity, and every diagram you've saved.

Free and Pro

Sign in with Google and the free plan keeps ten diagrams in your account. Pages you've already published stay up, and versions you already have stay readable. Pro, at $6 a month or $48 a year, makes diagrams unlimited and turns publishing, updating and version history on.

Present a diagram like a talk, without making slidesDiagramly's Present mode turns frames and pinned views into slides. The camera flies between them and each shape sketches itself in as you speak.
Type a line, get a diagram: the sketch line explainedHow Diagramly's text-to-diagram syntax works. Arrows, labels, branches, decisions and shape prefixes, with examples you can paste straight into the canvas.
Describe a system and the AI draws it, then Tidy lays it outDiagramly now draws from a sentence, edits on request, lays a messy diagram out in one click, routes arrows around shapes, and lets Pro users share templates.