- Docs
- Writing and linking
Rich blocks
Toggles, callouts and embeds in plain Markdown, including web embeds that load nothing until you click.
Rich blocks add structure to a note without leaving Markdown. Each one degrades to readable text in any other editor, so your notes never depend on Scaffold to make sense.
Toggles
A toggle hides its content until you open it. Start it with :::toggle followed by the label, and end it with :::.
:::toggle Packing list
- Tent and pegs
- Stove, two gas canisters
:::
- Write
:::toggle+to make the toggle start open. - Anything can go inside: lists, code, images, even other blocks.
- Scaffold also reads HTML toggles written as
<details><summary>Label</summary>…</details>.
Callouts
Callouts highlight a passage. They are block quotes whose first line names a type in brackets, followed by an optional title.
> [!tip] Before you leave
> Check the forecast for the ridge, not just the valley.
- The type picks the colour and icon, for example
note,tiporwarning. - Add
+or-after the brackets to make the callout foldable:> [!info]- Detailsstarts folded,> [!info]+ Detailsstarts open. - In other editors a callout reads as an ordinary quote.
Embeds
Notes, headings and files
Put ! in front of a wikilink to show the target inside the current note instead of linking to it.
![[Garden plan]]
![[Garden plan#Spring]]
![[diagram.png]]
Images, audio, video and PDF files from your vault are shown inline. Embedding a database note, such as
![[Projects/Projects.md]], shows its default view read-only; if that is not available in your build it falls back to
the ordinary note embed.
Web embeds
:::embed https://video.example/watch?v=ridge
:::
Web embeds are click-to-load. Scaffold shows a card with the address, and nothing from that site is fetched until you click it. Then:
- Only
https:addresses are loaded, inside a sandboxed frame that sends no referrer. - For well-known video hosts, Scaffold switches to the host’s privacy-friendly embed address.
- Any other address is shown as a link card instead of a frame.
Embeds never load on their own: not when a note opens, not in search results, not in exports.