Skip to content

Callouts

A callout is a coloured block inside a note for the part you don't want to skim past — a warning, a decision that's now locked, a rule you keep breaking.

Five types:

TypeUse it for
NoteQuiet context for future you
TipAdvice worth surfacing
ImportantSomething you must not lose
WarningPreventing a mistake
CautionA real risk if ignored

Each type has its own colour and icon, drawn from the same palette as the rest of MLW.

Adding one

Three ways, all in the note editor:

  • Slash command — type /note, /tip, /important, /warning, or /caution. The short forms /warn, /imp, /info, /danger and /callout work too.
  • Type it — type > [!tip] followed by a space and the block converts as you type.
  • From a selection — select text first, then use the slash command to wrap what you've already written.

Titles

Every callout has a title line. Leave it alone and it shows the type name ("Warning"). Type over it and you get whatever you want:

Founding rate is permanent Grandfathered for the life of the account, not 12 months.

You can also write a title and leave the body empty. That gives you a one-line rule, which is often all you need:

Never bundle a price change with a feature launch.

Changing the type

Click the icon on the left of the callout and pick a different type. The content stays where it is — no deleting and retyping.

What goes inside

Anything a note can hold: bold and italic, inline code, lists, links, [[wikilinks]], @task mentions, #tags, and highlights. A callout is a container, not a special text box.

To get out of an empty callout, press Backspace at the start of it.

How it's stored

Callouts are written as ordinary markdown:

> [!WARNING] Heads up
> Stripe descriptor is fixed once set.

This is the same syntax GitHub and Obsidian use. Two things follow from that:

  • Your notes stay plain markdown. Nothing proprietary is added to the file.
  • Callouts you write in MLW render as real callouts in Obsidian after exporting, and callouts written in Obsidian show up correctly in MLW.

On mobile

Callouts render on mobile too, in the same colours, in both the note editor and the Notes pane on Today. Writing one is a web thing for now — the mobile note editor is a plain markdown field, so you can type > [!TIP] by hand and it will render, but there's no slash menu or type picker there yet.