# タグ

タグを使うと、関連するコンテンツをグループ化したり、リリース状態を伝えたり、古くなったコンテンツを示したり、あるいは読者がドキュメントを素早く把握するのに役立つその他の方法で活用できます。

{% hint style="info" %}
**注:** タグは現在ベータ版です。検索機能や色のサポートを含む、さらに多くの機能を追加することを検討しています。タグについて見てみたい具体的な機能があれば、ぜひ [GitHubコミュニティでお知らせください](https://github.com/GitbookIO/community)!
{% endhint %}

## ページにタグを付ける

ページを開いてから、 **ページオプション** を開きます — これはページタイトルにカーソルを合わせると表示されます — そして1つ以上のタグを追加します。タグはドラッグして、ページ上で表示される順序を変更できます。

### ページ上のタグを表示または非表示にする

既定では、タグはページ上部に表示されます。関連するメタデータは保持したままページのタグを非表示にするには、次のようにします。

* 開く **ページオプション**
* をオフにする **ページにタグを表示** ことでタグをメタデータのみに保持する

### 目次にタグを表示する

各ページごとに、目次に表示するタグを1つ選べます [目次](https://gitbook.com/docs/creating-content/content-structure/page#table-of-contents) — このページで確認できるとおりです。どのタグを表示するかを選ぶには、次の手順を行います。

* 開く **ページオプション**
* の下で **タグ**、 **目次に表示** ドロップダウンからタグを選択します。

## 更新ブロックにタグを付ける

各個別の [更新ブロック](https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/blocks/updates) にも独自のタグを付けられます。

更新ブロックにタグを追加するには、その更新に移動して **タグを追加** を日付の下でクリックします。その後、タグピッカーを使ってタグの追加、削除、並べ替えができます。

## Library でタグを管理する

スペースのタグを表示、作成、管理するには、 **ライブラリ** から [目次](https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/content-structure/page/..#table-of-contents) を開き、 **タグ**.

各タグには次の要素があります。

* 1つの **label** — 読者に表示されるもの
* 1つの **スラッグ** — 安定した識別子
* 任意の **icon** または **絵文字**

## Markdown 内のタグ

Git Sync を使用している場合、タグはページのフロントマターに表示されます。

```yaml
---
description: "タグはページや更新ブロックに追加できる再利用可能なラベルです。このページでは、タグの作成、追加、管理の方法を説明します"
tags:
  - news
  - experiment
  - tag: beta
    primary: true
  - pro
---
```

標準タグには文字列を使用します。

使用 `primary: true` 1つのタグを指定して、そのページのプライマリタグにします。GitBook では、そのタグを目次に表示できます。

GitBook はリストのタグ順を保持します。