Callout
Think of a callout as a tiny, attention-seeking spotlight for your most important or interesting content. It's like a digital sticky note that screams, "Hey, look at me!". It's a versatile block that can be used to highlight tips, warnings, best practices, or just about anything you want to emphasize.
- Highlight Key Information Is there something super important your users need to know? A callout is your megaphone.
- Provide Helpful Tips Want to be the documentation hero? Drop some helpful tips in callouts.
- Warn About Potential Issues Prevent user tears by using callouts for warnings.
- Add a Touch of Personality Callouts can be your secret weapon for injecting some personality into your docs.
đ Pro Tip
Use callouts sparingly. Too many and they lose their impact. It's like shouting at someone - it works for a while, but then it just gets annoying.
Type / to open Archbee block menu
Search for Callout block and click to insert insert
Choose the callout style
- âšī¸ Info â For general information, tips, or quick facts.
- â Success â To celebrate accomplishments, highlight positive outcomes, or simply spread good vibes.
- īģŋâ ī¸ Warning â To alert users to potential issues, cautionary notes, or important considerations.
- đ Danger â For critical alerts, urgent messages, or situations that require immediate attention.
Feel free to add your content. You can style the content however you like using the WYSIWYG Menu or even insert other blocks, like:
Want to add callouts to your documentation directly through Markdown? We've got you covered you!
Archbee supports a specific Markdown syntax with triple colons (:::). With this method, you simply type :::hint followed by an optional style attribute to define the callout type (info, warning, success or danger).
Use the following Markdown to generate a callout block:
We would love you to contribute to @octokit/rest, pull requests are very welcome! Please see CONTRIBUTING.md for more information.
Alternatively, use this flavor of Markdown to generate a callout block.
Check the Use Markdown shortcutsīģŋ page to see more markdown shortcuts for other blocks.
Here are some examples to show you the callout block:
- âšī¸ Info
âšī¸ Did you know?
Archbee is so good, it'll make you question your life choices.
Like, why didn't you start using it sooner?
īģŋ
- â Success
đ You did it!
You've mastered the art of callouts.
Now go forth and create amazing documentation that will blow your competitors out of the water.
īģŋ
- īģŋâ ī¸ Warning
īģŋđ§ Heads up!
Using too many callouts can be distracting. Use them wisely, or your readers might start to ignore them altogether.
īģŋ
- đ Danger
īģŋđ¨ Uh-oh!
If you're seeing this, something has gone terribly wrong. đĢŖ
Probably not with Archbee though, we're perfect. đ â¨
Blame the coffee. âī¸
īģŋ
īģŋīģŋ Find other blocks
Discover new ways and blocks to create stunning and functional documentation pages.
īģŋCheck out all blocksīģŋ
īģŋīģŋ Need help? âŦī¸
Use the blue chat bubble from bottom right corner.
Or try AI Chat (from search box) for quick answers.
īģŋīģŋ Your opinion matters
Use the below feedback form, anonymously.
Or ask a question in Q&A section and our team or AI will give you a solution.
īģŋ
īģŋ
