> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks/hint.md).

# 提示

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

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

提示块支持 [内联内容](/url/gitbook.com/docs/documentation/zh/creating-content/formatting/inline.md) 和 [格式](/url/gitbook.com/docs/documentation/zh/creating-content/formatting.md)，以及一些特定的块类型。要查看你可以在提示中使用哪些块类型，请在 `/` 空行上按 [插入面板](/url/gitbook.com/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" icon="books" %}
这个提示块有一个自定义图标。
{% endhint %}

{% hint style="info" %}
## 这是一个 H2 标题

这是一个行

这是一个内联 <img src="../../.gitbook/assets/25_01_10_command_icon_light.svg" alt="The Apple computer command icon" data-size="line"> 图像

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-open-v2-preview.gitbook.workers.dev/url/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.