1. Docs
  2. Writing and linking

Rich blocks

Toggles, callouts and embeds in plain Markdown, including web embeds that load nothing until you click.

On this page

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, tip or warning.
  • Add + or - after the brackets to make the callout foldable: > [!info]- Details starts folded, > [!info]+ Details starts 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.