Skip to main content

Linking strata

Linking strata

A stratum is always bound to a shape on a surface. It can also be linked to from prose.

blueprint:josh/stratum-binding-vs-linking

Binding with the picker

The link picker opens the diagram in a read-only pick view. Click the shape you mean and the stratum binds to it.

The surface can be a diagram tab's own canvas, or a diagram embedded inside rich or raw content elsewhere in the blueprint. The binding is what lets a reader's click resolve to the right stratum when a blueprint holds several diagrams.

Linking from prose

Markdown links accept a stratum: scheme:

[see the auth flow](stratum:clx1a2b3c4)

Following the link opens that stratum, the same as clicking its shape.

One idschemerequired

stratum: followed by a single stratum id.

Several idslist

Comma-separated. All open together.

With a tabfragment

Add #tab=2 to open on a particular tab rather than the first.

Callouts take the same target, so a whole note becomes the link:

> [!NOTE|stratum:clx1a2b3c4] Where this is enforced

The stratum: scheme is understood by Blueprintr's editors and reader only. Everywhere else it is inert. Exported markdown never contains a broken external link, but the link will not resolve either. Export with that in mind.

Content written before strata were renamed used a stage: prefix. Blueprintr still reads stage: links and writes new ones as stratum:, so old blueprints keep working with no migration.