**帮助改进此页面** 

要帮助改进本用户指南，请选择位于每个页面右侧窗格中的**在 GitHub 上编辑此页面**链接。

# 插入链接
插入链接

AsciiDoc 支持多种类型的链接。使用正确的链接类型很重要，这样链接才能在不同的环境中正常工作。

## 链接到《EKS 用户指南》中的页面或章节


使用交叉引用（xref）在同一文档网站（例如《EKS 用户指南》）中的页面或章节之间进行链接。如果目标章节移动或重命名，链接会自动更新。

### 使用页面标题作为链接文本


对于本用户指南中链接到其他 ID 的大多数情况，请使用以下方法让链接文本根据需要自动更新为最新标题。

```
For more information, see <<page-or-section-id>>.
```

### 定义自定义链接文本


对于必须有自定义链接文本的情况，请使用以下格式。

```
Here's an example of a <<page-or-section-id,link with custom text>>.
```

## 链接到 Amazon 文档中的其他指南


1. 查找指向 Amazon 文档页面的链接。

1. 移除 `https://docs.aws.amazon.com/` 前缀，仅保留路径。路径应以字母开头。

1. 创建一个链接，如下所示：

```
link:AmazonS3/latest/userguide/create-bucket-overview.html[Create a bucket, type="documentation"]
```

## 链接到外部网页


这种格式会创建一个指向非 Amazon 托管页面的标准链接。例如，GitHub 链接可使用此格式。

```
https://example.com[Link text]
```

**注意**  
我们已设置外部域允许列表。允许名单位于 `vale/styles/EksDocs/ExternalDomains.yml`