Callout & Anchor Link Demo

Heading Anchors

All headings on this page have auto-generated anchor links. Hover over any heading to see the # link โ€” click it to get a shareable URL to that section. This is powered by rehype-slug (adds id attributes) + rehype-autolink-headings (adds clickable links).

You can link to any heading from other pages using fragments:

See the [Informational Callouts section](/demo/callouts/#informational-callouts) for details.

Informational Callouts

Note

โœŽNote

This is a note callout. Use it for supplementary information that doesnโ€™t fit the main flow but is helpful context for the reader.

Abstract

๐Ÿ“Abstract

This is an abstract callout. Ideal for summarizing a longer document or providing a brief overview before diving into details.

Summary

๐Ÿ“Key Takeaways

This is a summary callout with a custom title. Summaries help readers who are skimming quickly grasp the essential points.

TL;DR

๐Ÿ“TL;DR

Too long; didnโ€™t read โ€” this callout gives the short version for impatient readers.

Info

โ„น๏ธInfo

This is an info callout. It provides helpful contextual information that isnโ€™t critical but enhances understanding.


Task Callouts

Todo

โ˜‘๏ธTodo

This is a todo callout. Use it to mark action items or tasks that need to be completed.


Positive Callouts

Tip

๐Ÿ”ฅPro Tip

This is a tip callout with a custom title. Tips share helpful shortcuts or best practices that improve the readerโ€™s workflow.

Hint

๐Ÿ”ฅHint

This is a hint callout. Hints are subtle nudges that point the reader in the right direction without giving away the full answer.

Important

โ—Important

This is an important callout. Use it for information that readers absolutely must not skip โ€” critical prerequisites or key distinctions.

Success

โœ…Success

This is a success callout. Celebrate when something works! Great for confirming that a setup step completed correctly.

Check

โœ…Verification

This is a check callout. Use it as a verification checkpoint โ€” โ€œIf you see X, youโ€™re on the right track.โ€

Done

โœ…Done

This is a done callout. Marks completed steps or finished processes.


Question Callouts

Question

โ“Question

This is a question callout. Pose a thought-provoking question to engage the reader.

Help

โ“Help

This is a help callout. Direct readers to support resources or troubleshooting steps.

FAQ

โ“Common Question

This is a FAQ callout. Perfect for addressing frequently asked questions inline within your documentation.


Warning Callouts

Warning

โš ๏ธWarning

This is a warning callout. Warn readers about potential pitfalls or common mistakes before they encounter them.

Caution

โš ๏ธCaution

This is a caution callout. Slightly stronger than a warning โ€” proceed with care and double-check your steps.

Attention

โš ๏ธAttention

This is an attention callout. Draws the readerโ€™s eye to something that requires careful consideration.


Negative Callouts

Failure

โŒFailure

This is a failure callout. Documents known failure modes and what went wrong.

Fail

โŒFail

This is a fail callout. Marks a known anti-pattern or approach that will not work.

Missing

โŒMissing

This is a missing callout. Highlights missing pieces โ€” incomplete features, absent data, or gaps in coverage.


Danger Callouts

Danger

โ›”Danger

This is a danger callout. Use for operations that can cause data loss, security issues, or irreversible changes. Think twice before proceeding.

Error

โ›”Build Failed

This is an error callout. Shows error states and what to do when something goes wrong.

Bug

๐Ÿ›Known Issue

This is a bug callout. Documents known bugs or unresolved issues that users should be aware of.


Misc Callouts

Example

๐Ÿ“Example

This is an example callout. Provides a worked example that demonstrates the concept being discussed.

Quote

๐Ÿ’ฌQuote

This is a quote callout. Highlight notable quotes or references from external sources.

Cite

๐Ÿ’ฌCite

This is a cite callout. Provides citations or attribution for ideas, code, or content from other sources.


Mixed Content Inside Callouts

Callouts support rich Markdown content inside them:

๐Ÿ”ฅRich Content Inside Callouts

You can use all standard Markdown inside callouts:

Even blockquotes work inside callouts!

โš ๏ธCross-Page Linking

Remember that you can combine callouts with anchor links! Reference any heading on any page: