Callout

可以将 标注 想象成一个微小但吸引注意力的聚光灯,用于呈现最重要或最有趣的内容。它就像一个数字便签在喊:"嘿,看看我!"。 这是一个多功能的块,可用于突出提示、警告、最佳实践,或任何您想强调的内容。
为什么要使用 callout?
- 突出关键信息 有没有什么极其重要的事情需要用户知道?callout 就是您的扩音器。
- 提供有用提示 想成为文档中的英雄吗?在 callout 中放一些有用的提示吧。
- 警告潜在问题 通过使用 callout 发出警告,避免用户流泪。
- 增添个性化风格 callout 可以成为让您的文档更具个性的秘密武器。
😎 专家提示
请谨慎使用 callout。使用太多会削弱其效果。这就像对某人大喊——一开始挺管用,但很快就会令人厌烦。
如何使用 callout 块?

Markdown
想直接通过 Markdown 向文档添加 callout 吗?我们已经为您准备好了!
Archbee 支持使用三个冒号(:::)的专用 Markdown 语法。通过这种方法,您只需输入 :::hint,然后加入可选的 风格 属性以定义 callout 类型(info、warning、success 或 danger)。
使用以下 Markdown 来生成 callout 区块:
## Hints
:::hint{style="info"}
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see CONTRIBUTING.md for more information.
:::
:::hint{style="warning"}
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see CONTRIBUTING.md for more information.
:::
:::hint{style="success"}
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see CONTRIBUTING.md for more information.
:::
:::hint{style="danger"}
We would love you to contribute to `@octokit/rest`, pull requests are very welcome! Please see CONTRIBUTING.md for more information.
:::我们非常欢迎您为 @octokit/rest 做出贡献,非常欢迎 pull request!更多信息请参阅 CONTRIBUTING.md。
或者,您可以使用这种 Markdown 方式来生成一个 callout 区块。
{% hint style="info" %}
some hint
{% endhint %}
查看 使用 Markdown 快捷方式 页面以查看更多用于其他区块的 markdown 快捷方式。
示例
以下是一些展示 callout 区块的示例:
- ℹ️ 信息
ℹ️ 您知道吗?
Archbee 好用到让您开始怀疑人生。
比如,为什么您不早点开始用?
- ✅ 成功
🎉 您成功了!
您已经掌握了 callout 的艺术。
现在去创建令人惊艳的文档,让您的竞争对手望尘莫及吧。
- ⚠️ 警告
🚧 注意!
过多使用 callout 可能会产生干扰。请谨慎使用,否则读者可能会开始完全忽略它们。
- 🛑 危险
🚨 哎呀!
如果您看到这个,说明有些事情出大问题了。🫣
不过大概不是 Archbee 的问题,毕竟我们很完美。💅✨
怪咖啡吧。☕️


需要帮助?⬇️
使用右下角的 蓝色 聊天气泡。
或者尝试使用 AI 聊天(在搜索框中)以获取快速答案。

您的意见很重要
您可以匿名使用下方的反馈表。
或者在 问答区 提问题,我们的团队或 AI 会为您提供解决方案。
