Notes

A note is a highlighted block that contains important information.

Depending on the content, notes with different titles and formatting are used:

  • Note: Additional information.
  • Advice: A recommendation.
  • Important: A warning.
  • Attention: A restriction.
  • A note with its own header.

Notes can include any YFM markup, but we don't recommend overloading them with elements. Choose a simple design and don't overuse notes because this will distract the user from the main content.

Comment

{% note info %}

This is info.

{% endnote %}

Result

Note

This is info.

Tip

{% note tip %}

This is a tip.

{% endnote %}

Result

Tip

This is a tip.

Warning

{% note warning %}

This is a warning.

{% endnote %}

Result

Warning

This is a warning.

Alert

{% note alert %}

This is an alert.

{% endnote %}

Result

Alert

This is an alert.

Custom header

{% note info "Custom header" %}

This is a note with its own header.

{% endnote %}

Result

Custom header

This is a note with its own header.

{% note info "" %}

This is a note without a header.

{% endnote %}

Result

This is a note without a header.