# 提示

提示，或称标注，是一种很好的方式，可以将读者的注意力引导到文档中的特定元素上，例如提示、警告和其他重要信息。

共有四种不同的提示样式——你可以通过打开该块的 **选项菜单** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/e1df373962dc4830bcb786d7e5cb3cce603367d3" alt="The Options menu icon in GitBook"></picture> 并选择你想要的样式来更改样式。每种样式都使用默认图标，但你可以通过点击图标，并从 [我们的图标集](/docs/documentation/zh/creating-content/formatting/inline.md#icons).

提示块支持 [内联内容](/docs/documentation/zh/creating-content/formatting/inline.md) 并 [格式](/docs/documentation/zh/creating-content/formatting.md)，以及一些特定的块类型。要查看在提示中可以使用哪些块类型，请在 `/` 一个空行上按下 [插入面板](/docs/documentation/zh/creating-content/blocks.md#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="/files/ae70d946a816ad015af3717ad7535db25bab67a2" 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="苹果电脑的 command 图标" data-size="line"> 图片

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/creating-content/blocks/hint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
