> 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="broken://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%2Fgit-blob-23f3e8f05326b0d239d32d28bba99c1d46f204f7%2F25_01_10_options_light.svg?alt=media" alt="The Options menu icon in GitBook"></picture> 并选择所需的样式来更改样式。每种样式都使用默认图标，但你可以点击图标并从 [我们的图标集中](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md#icons).

提示块支持 [行内内容](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/formatting/inline.md) 和 [格式](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/formatting.md)，以及一些特定的块类型。若要查看提示中可使用哪些块类型，请在空行上按下 `/` ，然后查看 [插入菜单](https://gitbook.com/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%2Fgit-blob-60603650ac76d6e2b46bc0375cb75c8984543e7e%2F25_01_10_command_icon_light.svg?alt=media" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
