---
title: Callout
slug: docs/cn/callout
description: 是否有一些非常重要的事项需要让用户知道？标注提示就是你的扩音器。
createdAt: 2024-07-24T11:14:45.104Z
---
可以将 **标注** 想象成一个微小但吸引注意力的聚光灯，用于呈现最重要或最有趣的内容。它就像一个数字便签在喊：*"嘿，看看我！"。 *这是一个多功能的块，可用于突出提示、警告、最佳实践，或任何您想强调的内容。
## 为什么要使用 callout？
- **突出关键信息**
有没有什么极其重要的事情需要用户知道？callout 就是您的扩音器。
- **提供有用提示**
想成为文档中的英雄吗？在 callout 中放一些有用的提示吧。
- **警告潜在问题**
通过使用 callout 发出警告，避免用户流泪。
- **增添个性化风格**
callout 可以成为让您的文档更具个性的秘密武器。
:::hint{type="info"}
**😎 专家提示**
请谨慎使用 callout。使用太多会削弱其效果。这就像对某人大喊——一开始挺管用，但很快就会令人厌烦。
:::
## 如何使用 callout 块？
::::WorkflowBlock
:::WorkflowBlockItem
输入 `/` 以打开 Archbee 区块菜单
:::
:::WorkflowBlockItem
搜索 **标注** 区块并点击以插入
:::
:::WorkflowBlockItem
选择 callout 样式
- **ℹ️ 信息 **— 用于一般信息、提示或快速说明。
- **✅ 成功 **— 用于庆祝成就、突出积极结果或传递良好氛围。
- ⚠️** 警告 **— 用于提醒用户潜在问题、注意事项或重要考量。
- **🛑 危险** — 用于关键警报、紧急消息或需要立即关注的情况。
:::
:::WorkflowBlockItem
欢迎添加您的内容。您可以使用 [WYSIWYG Menu](#) 来随意调整样式，或插入其他区块，例如：
- [标题](docId\:f9FqgDFaoa8-TtG9OpQEW)
- [可展开标题](docId:37wrUKXmvYY2FFtpgOmO7)
- [Lists](docId\:q0U1u0MTYYTdbKaKLsSxF)
- [按钮](docId\:UI4jtExZ5_EtasD0MvhRo)
- [水平分隔线](docId\:UzqpQrYa2i5WwhZI_9TBz)
- [文件](docId\:zj8K-O7gYKFd_BLkuVBuY)
- [图像](docId\:Li_wQ4wX1zgWoBGFqfyNG)
- [视频](docId\:AWprIdYplayS98fRvNJJA)
:::
::::
## Markdown
想直接通过 Markdown 向文档添加 callout 吗？我们已经为您准备好了！
Archbee 支持使用三个冒号（`:::`）的专用 Markdown 语法。通过这种方法，您只需输入 `:::hint`，然后加入可选的 `风格` 属性以定义 callout 类型（info、warning、success 或 danger）。
使用以下 Markdown 来生成 callout 区块：
```markdown
## 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.
:::
```
:::hint{type="info"}
我们非常欢迎您为 `@octokit/rest` 做出贡献，非常欢迎 pull request！更多信息请参阅 CONTRIBUTING.md。
:::
或者，您可以使用这种 Markdown 方式来生成一个 callout 区块。
```markdown
{% hint style="info" %}
some hint
{% endhint %}
```
查看 [使用 Markdown 快捷方式](docId:5QfvRE_WOro_y1WBKKYLp) 页面以查看更多用于其他区块的 markdown 快捷方式。
## 示例
以下是一些展示 callout 区块的示例：
- **ℹ️ 信息**
:::hint{type="info"}
**ℹ️ 您知道吗？ **
Archbee 好用到让您开始怀疑人生。
比如，为什么您不早点开始用？
:::
- ✅ **成功**
:::hint{type="success"}
**🎉 您成功了！**
您已经掌握了 callout 的艺术。
现在去创建令人惊艳的文档，让您的竞争对手望尘莫及吧。
:::
- ⚠️** 警告**
:::hint{type="warning"}
**🚧** **注意！**
过多使用 callout 可能会产生干扰。请谨慎使用，否则读者可能会开始完全忽略它们。
:::
- 🛑 **危险**
:::hint{type="danger"}
🚨 ** 哎呀！**
如果您看到这个，说明有些事情出大问题了。🫣
不过大概不是 Archbee 的问题，**毕竟我们很完美。💅✨**
怪咖啡吧。☕️
:::
***
::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-C1IcmVcG0rx4ZLHX6X7V7-20250911-192557.png"}
:FontAwesome[]{icon="fa-solid fa-cubes"} ** 查找其他区块**
探索用于创建令人惊艳且实用的文档页面的新方法和区块。
[查看所有区块](docId\:B4IohMBgLgJ5t-HvaLMTF)
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-YRyGGWKsNS1ZZJa5XJy0z-20250911-192608.png"}
:FontAwesome[]{icon="fa-solid fa-headset"}** 需要帮助？⬇️**
使用右下角的 **蓝色** **聊天气泡**。
或者尝试使用 **AI 聊天**（在搜索框中）以获取快速答案。
:::
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-MS_ubDHlXgoktt4svD2rL-20250911-192619.png"}
:FontAwesome[]{icon="fa-solid fa-hand-holding-heart"}** 您的意见很重要**
您可以匿名使用下方的反馈表。
或者在 **问答区** 提问题，我们的团队或 AI 会为您提供解决方案。
:::
::::