インラインコンテンツ

インラインパレットを使用して画像、リンク、数式・TeXなどを追加する

コンテンツにインライン要素を追加します。

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

注釈

注釈を使うと、読み手の思考の流れを途切れさせることなく言葉に追加の文脈を付け加えられます。語の意味を説明したり、追加情報を挿入したりするのに使えます。読者は注釈されたテキストにカーソルを合わせると、テキストの上に注釈が表示されます。

注釈を作成する

注釈を作成するには、注釈したいテキストを選択し、コンテキストメニューの 注釈 オプションをクリックします。注釈を書いたら、テキストブロックでの執筆を続けるために注釈の外側をクリックします。

Markdown 表現

次のようにコンテンツを書くことができます： Markdown の脚注 を GitBook の注釈として追加します。脚注の指標は注釈したい語の直後に置くべきで、句読点や他の記号の後に置いてはいけません。

これは簡単な脚注です[^1]、そしてこちらはより長い脚注です[^bignote]。

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

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

    脚注に含めるために段落をインデントしてください。

    `{ my code }`

    好きなだけ段落を追加できます。

画像

インライン画像はページ上でテキストと並んで表示されます。

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

1. インラインサイズ： 画像はフォントに合わせて比例的にサイズ調整されます — アイコンやバッジに最適です。

2. 元のサイズ： 画像は元のサイズのままインライン表示され、最大幅は300ピクセルになります。

3. ブロックに変換： これによりインライン画像が 画像ブロックに変わり、コンテンツと同じ幅になります。

画像ブロックは より多くのサイズやキャプションの追加などのオプションを提供します — ただしテキストとインライン表示はされません。

Markdown での表現

インライン画像の例： <img src=".gitbook/assets/GitBook - Dark.jpg" alt="Dark version of GitBook logo" data-size="line">

絵文字

絵文字は / を押してインラインパレットを開くことで追加できます。あるいは : と入力すると絵文字のリストがその行内に直接表示されます — 絵文字の名前を入力して候補を絞り込むことができます。

Markdown での表現

:house:
:car:
:dog:

リンク

挿入できるリンクは3種類あります：

• 相対リンク

• 絶対リンク

• メールアドレス mailto リンク

相対リンク

相対リンクは、次のようにリンクすることで作成されます： ページ あなたのスペースですでに存在するもの。相対リンクを使用する利点は、ページのURL、名前、または場所が変更されても参照が最新のまま維持されるため、壊れたリンクが少なくなることです。

相対リンクを挿入する方法は次のとおりです：

1. リンクを挿入したい段落のどこかをクリックするか、テキストを選択します。

2. インラインパレットを開くには / を押して Link を選択するか、 Link コンテキストメニューのボタンをクリックするか、または ⌘ + K.

3. リンクしたいページのタイトルを入力し始めます。

4. ドロップダウンの検索結果からページを選択します。

5. を押します Enter.

絶対リンク

絶対リンクは、コンテンツにコピー＆ペーストできる外部リンクです。ドキュメント外の何かへのリンクを張りたいときに便利です。

絶対リンクを挿入するには：

1. リンクを挿入したい段落のどこかをクリックするか、テキストを選択します。

2. インラインパレットを開くには / を押して Link を選択するか、 Link コンテキストメニューのボタンをクリックするか、または ⌘ + K.

3. リンクしたいURLを貼り付けます。

4. を押します Enter.

なぜ外部リンクは新しいタブで開かないのですか？

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

GitBook はこの W3C 推奨の動作 に従い、 アクセシビリティ をサポートし、読者に対して一貫した包括的な体験を提供します。

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

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

メールアドレスの mailto リンクを挿入する方法は次のとおりです：

1. リンクを挿入したい段落のどこかをクリックするか、テキストを選択します。

2. インラインパレットを開くには / を押して Link を選択するか、 Link コンテキストメニューのボタンをクリックするか、または ⌘ + K.

3. を貼り付けるか入力します mailto:[e-mail] 、次の部分を置き換えて [e-mail] を使用したいメールアドレスに置き換えます。

4. を押します Enter.

Markdown での表現

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

数式と TeX

このオプションを使うと、コンテンツ内にインラインの数式を作成できます。例えば次のように： $f(x) = x * e^{2 pi i \xi x}$。我々は KaTeX ライブラリを使用して数式をレンダリングします。

また、 ブロックレベルの数式 を、空のブロックでコマンドパレットを開き、2つ目の Math & TeX オプションを選ぶことで挿入することもできます。

Markdown での表現

# Math and TeX ブロック

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

ボタン

ボタンは、行動喚起を強調したり、ドキュメントに検索バーや Ask AI バーを追加したりするのに最適です。読者をどこかへ誘導したり、回答を見つける手助けをするために使用できます。

ボタンのアクション

ボタンは単にURLへリンクする以上のことができます。ボタンを検索バーや GitBook Assistant に問い合わせるバーに変えることも可能で、ページ上から直接実行できます。これらのアクションは公開ページでも動作します — 下の例からもわかるように

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

リンクボタンを追加

読者を別のページや外部URLへ送信：アシスタントについて詳しく知る

検索バーを追加

オプションのプリセットクエリで検索を開く：

Ask AI/GitBook Assistantバーを追加

開く GitBookアシスタント オプションのプリセットプロンプト：

無効なボタンを追加

意図的にアクティブでないボタンを表示：

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

1. 種類 / そして選択 ボタン.

2. ボタンをクリックして開く ラベル メニュー。

3. アクションを選んで、ラベルとスタイルを設定します。

4. オプション：プリセットの検索クエリやアシスタントのプロンプトを追加できます。

スタイル

リンクと無効ボタンにはプライマリとセカンダリの両方のスタイルがあります。いくつかの例を示します：

GitBookにサインアップ トップへ移動

Markdown での表現

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

アイコン

アイコンはサイトに視覚的な目印を追加できます。段落内にインラインで、カードの中、または装飾を加えたい任意の場所に追加できます。これらはあなたのカスタマイズ設定で定義された視覚スタイルを使用します。 カスタマイズ設定.

訪問 Font Awesome で利用可能なさまざまなアイコンを確認してください。

Markdown での表現

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

式

式を使うと、変数で定義されたコンテンツを動的に表示できます 変数. 式はメニューから挿入できます。 / 挿入後、式をクリックすると式エディタが表示され、参照や 条件付き書式設定 を変数に適用できます。