<note type="tip">Don't fasten the bolts too tightly. First make sure all the pieces
fit well together, and then tighten them down firmly.</note>

There are actually quite a few options for note types: attention, danger, fastpath, important, notice, other, remember, restriction, tip, warning.

Sponsored content

Some of the types have different icons and formatting associated with them. All of notes transform to HTML with a class corresponding with their name.

If you're adding a note inside a task list, add the note inside the info element.

If you want a title to preface the note, use the fig element:
<fig><title>Bolt Warning</title>
<note type="tip">Don't fasten the bolts too tightly.
First make sure all the pieces fit well together, and then tighten them down firmly.</note>
</fig>