# 标签

您可以使用标签对相关内容进行分组，传达发布状态，标记过时内容，或者以任何其他有助于读者浏览您的文档的方式使用标签。

{% hint style="info" %}
**注意：** 标签目前处于测试版，因为我们正在考虑添加更多功能——包括搜索功能和颜色支持。如果您有想在标签中看到的具体功能，请 [在我们的 GitHub 社区告诉我们](https://github.com/GitbookIO/community)!
{% endhint %}

## 为页面添加标签

打开该页面，然后打开 **页面选项** ——可通过将鼠标悬停在页面标题上访问——并添加一个或多个标签。您可以拖动标签来更改它们在页面上显示的顺序。

### 在页面上显示或隐藏标签

默认情况下，标签会显示在页面顶部。若要在保留相关元数据的同时隐藏页面标签：

* 打开 **页面选项**
* 关闭 **在页面上显示标签** 以使标签仅作为元数据保留

### 在目录中显示标签

对于每个页面，您都可以选择一个标签显示在 [目录](https://gitbook.com/docs/creating-content/content-structure/page#table-of-contents) 中——正如您在此页面中所看到的。要选择显示哪个标签：

* 打开 **页面选项**
* 在 **标签**，请使用 **在目录中显示** 下拉菜单选择您的标签。

## 为更新块添加标签

每个单独的 [更新块](https://gitbook.com/docs/documentation/zh/creating-content/blocks/updates) 也可以拥有自己的标签。

要为更新块添加标签，请转到该更新并点击 **添加标签** ，位于日期下方。然后您可以使用标签选择器来添加、移除或重新排序标签。

## 在资料库中管理标签

要查看、创建和管理您空间中的标签，请打开 **资源库** 从 [目录](https://gitbook.com/docs/documentation/zh/creating-content/content-structure/page/..#table-of-contents) 并选择 **标签**.

每个标签都有：

* 一项 **label** ——读者看到的内容
* 一项 **slug** ——一个稳定的标识符
* 一个可选的 **icon** 或者 **表情符号**

## Markdown 中的标签

如果您使用 Git Sync，标签会显示在页面 frontmatter 中。

```yaml
---
description: "标签是可重复使用的标记，您可以将其添加到页面和更新块中——本页将告诉您如何创建、添加和管理标签"
tags:
  - 新闻
  - 实验
  - 标签：beta
    primary: true
  - 专业版
---
```

对于标准标签，请使用字符串。

使用 `primary: true` 在一个标签上将其设为页面的主标签。GitBook 可以在目录中显示该标签。

GitBook 会保留列表中的标签顺序。