跳转到内容
搜索文档

注释和其他记号类型

最后更新 查看 MarkdownAgent 设置

向页面添加注释时,请始终使用此特殊的注释格式。有三种类型的格式化注释:notecautiontip

这里有一些关于注释的附加信息:

  • 注释的颜色取决于注释的类型:note 是蓝色,caution 是黄色,tip 是紫色。
  • 对于每种注释类型,标题文本都是可选的。
  • 所有注释类型都可以包含文本以及其他格式(如列表、代码块和图像)。

要了解注释如何契合我们的内容策略,请参阅注释/提示/警告

注释 (Note)

对于微小的补充内容,或者当您需要提供对主要内容并非必不可少的额外上下文时,使用注释 (Note)。

如果您不提供标题,此旁注将默认显示为 Note

:::note[标题]
Hello, world!
:::

注意/警告 (Caution/Warning)

使用注意 (Caution) 来突出可能会给用户带来问题的操作。

如果您不提供标题,此旁注将默认显示为 Warning

:::caution[功能冲突]
如果您同时使用功能 A 和功能 B,您的配置将无法工作。
:::

提示 (Tip)

使用提示 (Tip) 来分享不适合放入主要文档的最佳实践或具有倾向性的用例。

如果您不提供标题,此旁注将默认显示为 Tip

:::tip[最佳实践]
Cloudflare 建议您使用 [1.1.1.1](/1.1.1.1/) 作为您的 DNS 解析器。
:::

这篇文档对您有帮助吗?