# 提示

提示（Hints）或标注（callouts）是吸引读者注意文档中特定元素的好方法，例如提示、警告以及其他重要信息。

有四种不同的提示样式——你可以通过打开该区块的 **选项菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FaS1QvPIBVYwhpFTGcPBN%2Foptions-menu.svg?alt=media&#x26;token=3ee40bbf-f4fb-41fa-aa30-306b559cbe88" alt="The Options menu icon in GitBook"></picture> 并选择你想要的样式来更改样式。每种样式都使用默认图标，但你可以通过点击图标并从中选择另一个图标来自定义它 [我们的图标集](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/formatting/inline#icons).

提示块支持 [行内内容](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/formatting/inline) 并在 [格式](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/formatting)，以及一些特定的块类型。要查看在提示中可以使用哪些块类型，请在 `/` 空行上按 [插入面板](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/blocks/..#inserting-a-new-content-block).

### 提示块示例 <a href="#example-of-a-hint" id="example-of-a-hint"></a>

{% hint style="info" %}
**信息提示** 非常适合展示一般信息，或提供技巧和窍门。
{% endhint %}

{% hint style="success" %}
**成功提示** 适合展示积极的行为或成就。
{% endhint %}

{% hint style="warning" %}
**警告提示** 适合展示重要信息或非严重警告。
{% endhint %}

{% hint style="danger" %}
**危险提示** 适合突出破坏性操作或引起对关键信息的注意。
{% endhint %}

{% hint style="info" icon="books" %}
这个提示块有一个自定义图标。
{% endhint %}

{% hint style="info" %}

### **这是一个 H2 标题**

这是一行

这是一个行内 <img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0FzoF68PAY3Rv297meNB%2Fcommand.svg?alt=media&#x26;token=b07ff261-6e28-4879-8ab1-039a49f6ab41" alt="The Apple computer command icon" data-size="line"> 图片

* 这是第二个 <mark style="color:橙色;background-color:purple;">使用无序列表和颜色的行</mark>
  {% endhint %}

要给你的提示添加标题，你需要在提示中创建一个标题块，并将其作为第一个块。

### 在 Markdown 中的表示

```markdown
{% hint style="info" %}
**信息提示**非常适合展示一般信息，或提供技巧和窍门。
{% endhint %}

{% hint style="success" %}
**成功提示**适合展示积极的行为或成就。
{% endhint %}

{% hint style="warning" %}
**警告提示**适合展示重要信息或非严重警告。
{% endhint %}

{% hint style="danger" %}
**危险提示**适合突出破坏性操作或引起对关键信息的注意。
{% endhint %}

{% hint style="info" %}

{% hint style="info" icon="books" %}
这个提示块有一个自定义图标。
{% endhint %}

## 这是一个 H2 标题

这是一行

这是一个行内 <img src="../../.gitbook/assets/25_01_10_command_icon_light.svg" alt="苹果电脑命令键图标" data-size="line"> 图片

- 这是第二行，使用了无序列表和 <mark style="color:orange;background-color:purple;">颜色</mark>
{% endhint %}
```