Skip to main content

Editor

Editor

Open the editor with Create blueprint on the dashboard, or by editing an existing blueprint. The three steps can be visited in any order; only publishing is gated.

blueprint:josh/the-editor-s-three-steps

1. Content

Title and tabs. The first tab must be a diagram.

The canvas fills most of the step. The engine menu switches between Vellum, draw.io, Excalidraw and Mermaid; Vellum is the default unless you have changed it in Settings → General.

Right-clicking a shape offers Add Stratum… here, so detail can be written before the diagram is finished.

2. Resources & Strata

Everything alongside the diagram: strata, further diagrams that are not tabs, and uploaded files organised into folders.

Skippable on a first pass.

3. Publish

1
Review the suggested tags

Generated from your content. Correct them: they drive discovery and the related-content rail.

3
Clear the pre-flight checks

Empty canvases, empty tabs and missing titles are blocked here rather than shipped. Each item in the list links to the thing to fix.

4
Publish

Sets a version. Readers see that version until you publish again.

Preview shows the reader's view without publishing, including strata and tab chrome. Use it before the first publish rather than after.