Skip to main content

Content blocks

Content blocks

Rich text in Blueprintr is markdown plus a component library. The same components work in a blueprint's Rich Text tabs, in a stratum's Rich tab, and on every folium page, including this one.

Every component is written as a blockquote whose first line is a marker. That format survives the visual editor, and degrades to a readable quote in any plain markdown renderer.

Callouts

> [!NOTE]
> Ordinary supporting detail.

Available kinds: NOTE, TIP, IMPORTANT, INFO, FAQ, TLDR, QUOTE.

A callout can link to a stratum: > [!NOTE|stratum:abc123] Title.

Procedures

> [!STEPS]
>
> === Install the CLI
>
> Run the installer.
>
> === Authenticate
>
> Then sign in.

Steps are numbered automatically. A plain ordered list inside [!STEPS] works too.

Panels and grids

=== Label on its own line separates panels in every multi-panel component.

MarkerRenders
[!TABS]Tabbed panels
[!CODETABS]Tabbed code blocks, one fence per panel
[!ACCORDIONS]Collapsible <details>, no JavaScript
[!COLUMNS n]An n-column responsive grid
[!TILES n]A tile grid, for navigation
[!CARDS]A card grid built from a markdown list
[!PANEL] TitleAn aside

API and reference

> [!FIELDS]
>
> > [!FIELD userId|string|required]
> >
> > The caller's user id.
>
> > [!RESPONSE createdAt|datetime]
> >
> > When the record was written.

Inline pieces

MarkerRenders
[!BADGE green] StableA small label. Colours: gray, blue, green, amber, red, purple, teal, pink
[!ICON rocket] Ship itA Lucide glyph, optionally labelled
[!TOOLTIP hint text]A term with a hover and focus hint
[!BANNER warning]A page-level banner. Types: info, warning, success, error
[!TREE]A file tree, from a nested markdown list
[!UPDATE v2.1.0|2026-09-05]A dated changelog entry
[!FRAME]A decorative frame
[!DETAILS] SummaryOne collapsible block. [!DETAILS|open] starts expanded

Audience splitting

> [!VISIBILITY agents]
>
> Notes for an AI agent reading this page.

Content marked agents is removed before the HTML reaches a human reader, and content marked humans is removed for an agent. Use it for machine-readable hints you do not want on the page.

A malformed marker degrades to an ordinary blockquote rather than being dropped. If a component renders as a plain quote, the marker line is wrong.

Embeds

SyntaxEmbeds
![diagram:vellum](url)A diagram from an uploaded source
![blueprint:handle/slug](embed-url)Another blueprint
![video](url)A video

Diagram embeds can be resized by dragging their corners; the size is written back into the markdown.