Skip to content
Lapis Notes Lapis Notes

Callouts

Lapis supports both block callouts and inline list callouts so important items stand out without leaving Markdown.

The public docs site does not run the app renderer for these custom surfaces, so this page shows the syntax and explains how they appear in notes.

Block callouts

Section titled “Block callouts”

Callouts are blockquotes with a type marker.

> [!note]
> This is a note callout.


> [!warning]
> Review this before publishing.

Use callouts for content that should break the reading rhythm on purpose:

  • Warnings and irreversible actions
  • Tips and reminders
  • Important context inside long reference notes

List callouts

Section titled “List callouts”

List callouts are inline markers inside list items.

- & Highlighted follow-up item
- ? Open question to revisit later
- ! High-risk issue
- @ Reading note or reference item

Default list-callout markers cover highlighted, warning, question, reference, success, muted, and other emphasis states. They render in source, live preview, and reading mode.

When to use them

Section titled “When to use them”
  • Use block callouts for a full paragraph or multi-line note.
  • Use list callouts when the emphasis belongs to one bullet in a larger list.
  • Keep them selective so the page still has a clear visual hierarchy.
Section titled “Related pages”