> For the complete documentation index, see [llms.txt](https://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.com/docs/documentation/zh/chuang-jian-nei-rong/blocks/hint.md).

# 提示

向页面添加提示，以吸引读者注意特定的重要信息。

提示（或标注）是吸引读者注意文档中特定元素的绝佳方式，例如提示、警告和其他重要信息。

共有四种不同的提示样式——你可以通过打开该块的 **选项菜单** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" 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&amp;token=3ee40bbf-f4fb-41fa-aa30-306b559cbe88" alt="The Options menu icon in GitBook"></picture> 并选择你想要的样式来更改样式。每种样式都使用默认图标，但你可以点击图标，并从 [我们的图标集](/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md#icons).

提示块支持 [行内内容](/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md) 以及 [格式](/docs/documentation/zh/chuang-jian-nei-rong/formatting.md)，以及一些特定的块类型。要查看在提示中可以使用哪些块类型，请在 `/` 空白行上按 [插入面板](/docs/documentation/zh/chuang-jian-nei-rong/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="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0FzoF68PAY3Rv297meNB%2Fcommand.svg?alt=media&amp;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" icon="books" %}
这个提示块有一个自定义图标。
{% endhint %}

{% hint style="info" %}
## 这是一个 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
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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/blocks/hint.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.