# Markdown

<figure><img src="/files/5092c52c85ddf81697890d49206d9105ad3f03ad" alt="An image containing the markdown logo"><figcaption><p>GitBook で Markdown を書きます。</p></figcaption></figure>

GitBook のエディターでは、Markdown を使って整形されたコンテンツを作成できます。

Markdown は、シンプルさで広く知られている人気のマークアップ構文です。GitBook は、リッチで構造化されたテキストを入力するための、キーボードにやさしい方法としてこれをサポートしています。

{% hint style="info" %}
Markdown自体については、以下を訪問して詳しく学べます [Common Mark](https://commonmark.org/help/).
{% endhint %}

### テキストの書式設定 <a href="#text-formatting" id="text-formatting"></a>

GitBook は、従来のインライン Markdown 書式設定をすべてサポートしています:

| 書式設定     | Markdown バージョン    | 結果        |
| -------- | ----------------- | --------- |
| 太字       | `**bold**`        | **太字**    |
| 斜体       | `_italic_`        | *斜体*      |
| 取り消し線    | `~strikethrough~` | ~~取り消し線~~ |
| インラインコード | `` `code` ``      | `コード`     |

### 改行

押して `Enter` 新しい段落を開始します。

押して `Shift` + `Enter` 同じ段落内でソフト改行を挿入します。

### Markdown の貼り付け

Markdown コンテンツをエディターに直接貼り付ける場合は、 **スタイルを合わせて貼り付け** オプションを使用することが重要です（通常は <kbd>Shift</kbd> + <kbd>Cmd</kbd> + <kbd>V</kbd> Mac では、または <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>V</kbd> Windows では）。

他のエディターやウェブからコピーしたコンテンツに通常の［貼り付け］オプションを使うと、整形されたテキストではなくコードブロックとして挿入される場合があります。

### タイトル

* 見出し 1: `# 1 レベルのタイトル`
* 見出し 2: `## 2 レベルのタイトル`
* 見出し 3: `### 3 レベルのタイトル`

### コードブロック

` ```⏎ ` は新しいコードブロックを作成します。

` ```py⏎ ` は、Python のシンタックスハイライト付きの新しいコードブロックを作成します。

私たちは [Prism](https://github.com/PrismJS/prism) をシンタックスハイライトに使用しています。 [Test Drive Prism](https://prismjs.com/test.html#language=markup) を使って、対応言語を確認してください。

GitBook と Prism に差がある場合、私たちのほうが 1、2 バージョン古い可能性があります。

### リスト

GitBook は、入力に応じて順序付きリストと順序なしリストを自動的に検出して作成します。

* 行の先頭に `-` または `*` を付けると、順序なしの箇条書きを開始します。
* 行の先頭に `1.` を付けると、番号付きリストを開始します。
* 行の先頭に `- [ ]` を付けると、タスクリストを開始します。

リストを書くときは、 `Tab` を押してインデントし、 `Shift+Tab` でインデントを戻します。

### 引用

行の先頭に `>` ブロック引用を作成します。段落全体を先頭から末尾まで選択してから `>` と入力すると、コンテンツ全体がブロック引用で囲まれます。

> これはブロック引用です。

### 区切り線

入力します `---` その後、 `Enter` を押して、ページに区切り線を作成します。

***

これは区切り線の例です。


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/formatting/markdown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
