> 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/ja-gitbook-documentation/kontentsuwosuru/formatting/inline.md).

# インラインコンテンツ

<figure><img src="/files/bec7f1a829a0f207a163d28ae19729dd44350498" alt="A GitBook screenshot showing inline content options"><figcaption><p>コンテンツにインライン要素を追加します。</p></figcaption></figure>

インラインパレットを使うと、キーボードから手を離さずにテキストブロックへ追加のコンテンツをすばやく挿入できます。単に `/` 任意のテキストブロックで / を押すと、インラインパレットが開きます。スラッシュは、挿入するコンテンツに置き換えられます。

## 注釈

注釈を使うと、読者の思考の流れを妨げずに、言葉に追加の文脈を加えられます。単語の意味を説明したり、追加情報を挿入したり、さまざまな用途に使えます。読者は注釈付きのテキストにカーソルを合わせると、テキストの上に注釈を表示できます。

### 注釈を作成する

注釈を作成するには、注釈を付けたいテキストを選択して、 **「注釈を付ける」** オプションをコンテキストメニューでクリックします。注釈を書き終えたら、その外側をクリックしてテキストブロックへの記述を続けます。

### Markdown表記

コンテンツを [Markdownの脚注](https://www.markdownguide.org/extended-syntax/#footnotes) として記述し、GitBook に注釈として追加できます。脚注の番号は、注釈を付けたい単語の直後に表示される必要があり、句読点やその他の記号の後に表示されてはいけません。

```markdown
こちらは簡単な脚注[^1]、こちらは長めの脚注[^bignote]です。

[^1]: これは最初の脚注です。

[^bignote]: 複数の段落とコードを含む脚注です。

    段落をインデントして脚注に含めます。

    `{ my code }`

    必要なだけ段落を追加できます。
```

## 画像

インライン画像はページ上で本文の横に表示されます。

デフォルトでは、画像は元のサイズで、最大幅は300pxに設定されています。画像をクリックして書式設定パレットを開き、次の3つのオプションのいずれかを選んでサイズを変更できます:

1. **インラインサイズ:** 画像はフォントに合わせて比率を保ってサイズ調整されます。アイコンやバッジに最適です。
2. **元のサイズ:** 画像は元のサイズのままインライン表示され、最大幅は300ピクセルです。
3. **ブロックに変換:** インライン画像を画像ブロックに変換します。幅はコンテンツと同じになります。

{% hint style="info" %}
画像ブロックでは、より多くのサイズやキャプションの追加など、さらに多くのオプションを利用できますが、本文の中には表示されません。
{% endhint %}

### Markdown での表記

{% code overflow="wrap" %}

```markdown
こちらはインライン画像です: <img src=".gitbook/assets/GitBook - Dark.jpg" alt="Dark version of GitBook logo" data-size="line">
```

{% endcode %}

## 絵文字

を押すと絵文字を追加できます `/` インラインパレットを開けます。別の方法として、 `:` と入力すると、絵文字の一覧が行内に直接表示されます。絵文字の名前を入力し始めると、候補を絞り込めます。

### Markdown での表記

{% code overflow="wrap" %}

```markdown
:house:
:car:
:dog:
```

{% endcode %}

## リンク

3種類のリンクを挿入できます:

* [相対リンク](#relative-links)
* [絶対リンク](#absolute-links)
* [メールアドレス `mailto` リンク](#email-address-mailto-links)

### 相対リンク

相対リンクは、セクション内にすでに存在するページへリンクすることで作成されるリンクです。相対リンクを使う利点は、ページのURL、名前、場所が変わっても参照が最新の状態に保たれることです。そのため、リンク切れを減らせます。

相対リンクの挿入方法:

1. 段落内のリンクを挿入したい場所をクリックするか、テキストを選択します。
2. / を押してインラインパレットを開き、Link を選ぶか、 **リンク** ボタンをコンテキストメニューでクリックするか、 **⌘ + K**.
3. リンク先にしたいページのタイトルを入力し始めます。
4. ドロップダウンの検索結果からページを選択します。
5. を押します `Enter`.

### 絶対リンク

絶対リンクは、コピーしてコンテンツに貼り付けられる外部リンクです。ドキュメントの外部にある何かへリンクしたいときに便利です。

絶対リンクの挿入方法:

1. 段落内のリンクを挿入したい場所をクリックするか、テキストを選択します。
2. / を押してインラインパレットを開き、Link を選ぶか、 **リンク** ボタンをコンテキストメニューでクリックするか、 **⌘ + K**.
3. リンク先にしたいURLを貼り付けます。
4. を押します `Enter`.

{% hint style="info" %}
**なぜ外部リンクは新しいタブで開かれないのですか？**

ドキュメントに外部サイトへのリンクを追加すると、同じタブで開きます。

GitBookはこれに従っています [W3C推奨の動作](https://www.w3.org/TR/WCAG20-TECHS/G200.html) を [アクセシビリティ](https://it.wisc.edu/learn/make-it-accessible/websites-and-web-applications/when-to-open-links-in-a-new-tab/) そして、読者に一貫した、包括的な体験を提供するためです。
{% endhint %}

### メールアドレスのmailtoリンク

メールアドレス `mailto` リンクは、訪問者がリンクをクリックすると既定のメールクライアントが開き、次の項目が入力されるようにしたいときに便利です。 `宛先` フィールドにリンク先のメールアドレスが入るため、送信するメールを書けます。

メールアドレスのリンクの挿入方法: `mailto` リンク:

1. 段落内のリンクを挿入したい場所をクリックするか、テキストを選択します。
2. / を押してインラインパレットを開き、Link を選ぶか、 **リンク** ボタンをコンテキストメニューでクリックするか、 **⌘ + K**.
3. 貼り付けるか入力します `mailto:something@address.com`、を置き換えて `something@address.com` を使用したいメールアドレスに置き換えます。
4. を押します `Enter`.

### Markdown での表記

```markdown
[これはこのセクション内の別ページへの相対リンクです](../content-structure/page.md)
[これは絶対リンクです](https://www.gitbook.com/blog)
[これはリンクです](mailto:support@gitbook.com) はサポート用メールアドレスへのリンクです
```

## 数式 & TeX

このオプションを使うと、コンテンツ内に次のようなインライン数式を作成できます: $$f(x) = x \* e^{2 pi i \xi x}$$。私たちは [KaTeX](https://katex.org/docs/supported.html) ライブラリを使って数式をレンダリングしています。

{% hint style="info" %}
空のブロックでコマンドパレットを開き、2つ目の「Math & TeX」オプションを選ぶと、ブロックレベルの数式も挿入できます。
{% endhint %}

### Markdown での表記

```markdown
# Math and TeX ブロック

$$f(x) = x * e^{2 pi i \\xi x}$$
```

## ボタン

ボタンは、CTAを強調したり、ドキュメントに検索バーやAsk AIバーを追加したりするのに最適です。読者を別の場所へ誘導したり、答えを見つける手助けをしたりできます。

### ボタンのアクション

ボタンはURLへのリンク以上のことができます。ページ上から直接、ボタンを検索バーやGitBook Assistantに質問するバーに変えることもできます。これらのアクションは公開済みページでも機能します。下の例で確認できます。

次のアクションを設定できます:

#### **リンクボタンを追加**

読者を別のページや外部URLに送ります:<a href="/pages/d74007c5891dbdec7feb5c3c8732f5a684aa5e91" class="button primary" data-icon="gitbook-assistant">Assistant について詳しく見る</a>

#### **検索バーを追加**

任意の事前設定クエリで検索を開きます: <button type="button" class="button primary" data-action="search" data-icon="magnifying-glass">検索...</button>

#### **Ask AI/GitBook Assistantバーを追加**

任意の事前設定プロンプトでGitBook Assistantを開きます: <button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">質問を入力...</button>

#### **無効なボタンを追加**

意図的に非アクティブなボタンを表示します:<a class="button primary">非アクティブなボタン</a>

### ボタンを作成して設定する

1. 種類 `/` を開いて **ボタン**.
2. ボタンをクリックして **ラベル** メニュー。
3. アクションを選び、ラベルとスタイルを設定します。
4. 任意: 事前設定済みの検索クエリまたはAssistantプロンプトを追加します。

### スタイル

リンクボタンと非アクティブボタンには、プライマリとセカンダリの両方のスタイルがあります。いくつかの例を示します:

<a href="https://app.gitbook.com/join" class="button primary">GitBook にサインアップ</a> <a href="#annotations" class="button secondary">先頭へ移動</a>

### Markdown での表記

```markdown
<a href="https://app.gitbook.com" class="button primary">GitBook</a>
```

## アイコン

アイコンを使うと、サイトに視覚的な補助表示を追加できます。段落内やカード内、あるいは装飾を加えたい場所ならどこにでもインラインで追加できます。見た目はカスタマイズ設定で定義したスタイルが使用されます。

<i class="fa-facebook">:facebook:</i> <i class="fa-github">:github:</i> <i class="fa-x-twitter">:x-twitter:</i> <i class="fa-instagram">:instagram:</i>

訪れて [Font Awesome](https://fontawesome.com/) 利用可能なさまざまなアイコンを確認できます。

### Markdown での表記

```markdown
<i class="fa-github">:github:</i>
```

## 式

式を使うと、変数で定義されたコンテンツを動的に表示できます。式は、 `/` メニューから挿入できます。挿入後に式をクリックすると式エディタが開き、参照したり [条件付きで書式設定したり](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_operator) 変数を


---

# 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/ja-gitbook-documentation/kontentsuwosuru/formatting/inline.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.
