> 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/creating-content/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 %}

## 絵文字

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

### 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) はサポート用メールアドレスへのリンクです
```

## Math & 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/creating-content/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.
