基本の書き方

段落と改行

文章はそのまま入力するだけで表示されます。

• 改行 ：行を変えると、そのまま改行されます。
• 段落を分ける ：空行（何も書かない行）を 1 行入れます。

記述例

1 行目の文章です。
改行した 2 行目の文章です。

空行を入れると、新しい段落になります。

見出し

行の先頭に「#」（シャープ）を付けると見出しになります。「#」の数で見出しの大きさ（レベル）が決まります。

記述例

## 大見出し
### 中見出し
#### 小見出し

• 「#」と見出しの文字の間には、 半角スペース を 1 つ入れてください（全角スペースでは見出しになりません）。
• 見出し 1（# 1 個）は、ページのタイトルに使われるので、本文では見出し 2 から使います。

文字の装飾

文字を記号で囲むと、装飾できます。

記述例

• 記号と文字の間に空白を入れると、装飾されません（** 太字 ** は不可）。
• 小さい文字の記号「•」（ビュレット）は、Mac では Option（Alt）+ 8 で入力できます。
• 「1~2 時間」のように半角の「~」を 2 つ書くと、その間が下付き文字になってしまいます。範囲は全角の「〜」で書いてください。

太字がうまく効かないとき

これは**「重要」**です のように、記号のすぐ内側に「」や（）があると、太字にならないことがあります。その場合は、記号の外側に半角スペースを入れてください。

これは **「重要」** です

リンク

リンクは [表示する文字](URL) の形で書きます。

記述例

[Google へのリンク](https://www.google.co.jp/)

https://www.google.co.jp/

• URL をそのまま書いても、自動でリンクになります。
• ページ内の見出しへのリンク ：見出しには、見出しの文字と同じ ID が自動で付きます。[見出しへ移動](#見出しの文字) のように書くと、その見出しへ移動するリンクになります（英字は小文字、空白は -、記号は取り除いた形で書きます）。

画像

画像は、リンクの先頭に「!」を付けた ![画像の説明](画像のURL) の形で書きます。

記述例

![猫の画像](https://code-plus.jp/gp/wp-content/uploads/PKST615_0I9A6442_TP_V.jpg)

表示例

• 「画像の説明」は、画像が表示されないときや、音声読み上げで使われます。どんな画像か分かる言葉を書いてください。
• 画像の大きさは指定できません。大きさを変えたいときは、HTML の <img> タグで書きます。

箇条書きリスト

行の先頭に「-」（ハイフン）と半角スペースを付けると、箇条書きになります。

記述例

- りんご
  - みかん
  - 温州みかん
- デコポン
- バナナ

• 行の先頭に半角スペースを 2 つ入れると、1 段下がった項目になります。
• リストの前には、空行を入れてください。

番号付きリスト

行の先頭に「数字」「.」「半角スペース」を付けると、番号付きのリストになります。

記述例

1. 材料を食べやすい大きさに切って、
たれを作っておく
2. 中火で材料を炒める
3. 調味料を入れて煮詰めれば出来上がり

※番号は自動で振られるので、すべて「1.」で書いても同じ結果になります。

リスト内を入れ子（ネスト）にする

リストの階層に合わせて、インデントします。

リスト > 定義リスト

- 12/9㊏
  - 開店〜12時まで
  : ピーマン 48円
  : じゃがいも 68円
  - 16時から
  : 鮭切身（4切） 398円
- 12/10㊐
  - 開店〜12時まで
  : りんご（小箱） 880円
  - 16時から
  : ぶなしめじ 58円
  : えのき茸 62円

リスト > テーブル

- りんご
  | 名前 | 価格 | 個数 |
  | --- | --- | --- |
  | りんご | 100円 | 3個 |
  | バナナ | 80円 | 5個 |
  | みかん | 120円 | 8個 |
- みかん
- 温州みかん

定義リスト（用語と説明）

「-」で用語を書き、次の行に「:」（コロン）と半角スペースで説明を書くと、用語と説明の組み合わせのリストになります。

記述例

- 営業時間
: 10:00〜18:00
- 定休日
: 毎週水曜日
: 年末年始

1 つの用語に、説明を複数書くこともできます。

定義リスト内を入れ子（ネスト）にする

定義リスト内も入れ子にすることができます。

定義リスト > 定義リスト

- 12/8㊎
: 開店〜12時まで
  - ピーマン
  : 48円
  - じゃがいも
  : 68円
  : 16時から
  - 鮭切身（4切）
  : 398円
- 12/9㊏
: 開店〜12時まで
  - りんご（小箱） 
  : 880円
  : 16時から
  - ぶなしめじ 
  : 58円
  - えのき茸 
  : 62円

定義リスト > リスト

- 12/9㊏
: 開店〜12時まで
  - ピーマン 48円
  - じゃがいも 68円
: 16時から
  - 鮭切身（4切） 398円
- 12/10㊐
: 開店〜12時まで
  - りんご（小箱） 880円
: 16時から
  - ぶなしめじ 58円
  - えのき茸 62円

定義リスト > テーブル

- 12/9㊏
: 開店〜12時まで
  - ピーマン 48円
  - じゃがいも 68円
: 16時から
  | 名前 | 価格 | 個数 |
  | --- | --- | --- |
  | りんご | 100円 | 3個 |
  | バナナ | 80円 | 5個 |
  | みかん | 120円 | 8個 |
- 12/10㊐
: 開店〜12時まで
  - りんご（小箱） 880円
: 16時から
  | 名前 | 価格 | 個数 |
  | --- | --- | --- |
  | りんご | 100円 | 3個 |
  | バナナ | 80円 | 5個 |
  | みかん | 120円 | 8個 |

タスクリスト

行頭に 、- [ ] （未完了）や - [x] （完了）と記述することでタスクリストを作成できます。

記述例

- [ ] 未完了のタスク
- [x] 完了したタスク

• 対応する書き方：[x] と [X] のどちらでも完了になります。入れ子の項目や、番号付きリスト（1. [ ] …）でも使えます。
• 普通の項目との混在：普通の項目と混ぜても、[ ] [x] のある項目だけがチェックボックスになります。
• リンクとの区別：[リンク](URL) で始まる項目は、タスクとして扱いません（ [ の後が空白か x 1 文字で、] の後が空白のものだけが対象です）。

引用

行の先頭に「>」（大なり記号）を付けると、引用になります。

記述例

> これは引用された文章です。
> 引き続き引用部分です。

水平線

「-」（ハイフン）を 3 つ以上、1 行に書くと、区切りの線になります。

記述例

---

※文章のすぐ下に書くと見出しとして扱われることがあるので、水平線の上には空行を入れてください。

コード

プログラムのコードや、記号をそのまま見せたい部分に使います。

インラインコード（文中）

文中の文字を「`」（バッククォート）で囲みます。

記述例

設定画面の `保存` ボタンを押します。

コードブロック（複数行）

前後の行を「```」（バッククォート 3 つ）で囲みます。「```」の後ろに言語名（html css js など）を書くと、色分けされて表示されます。

記述例

```js
function hello() {
console.log("こんにちは、世界！");
}
```

function hello() {console.log("こんにちは、世界！");}

コードの中に書いた記号は、Markdown として変換されず、そのまま表示されます。

表（テーブル）

「|」（縦線）で列を区切り、1 行目（見出しの行）の下に「|---|」の行を入れます。

記述例

| 名前 | 価格 | 個数 |
| --- | --- | --- |
| りんご | 100円 | 3個 |
| バナナ | 80円 | 5個 |
| みかん | 120円 | 8個 |

• 「|」の位置は揃えなくてもかまいません（揃えると、書くときに見やすくなります）。
• 見出しの行が必要ない表は、「|---|」の行を省略できます。

表の応用

セルの結合

セルに「<」「>」「^」だけを書くと、となりのセルと結合できます。

記述例

| 時間 | 月曜 | 火曜 |
| --- | --- | --- |
| 10:00〜12:00 | 会議 | < |
| 13:00〜15:00 | 外出 | 作業 |
| 15:00〜17:00 | ^ | 作業 |

表のタイトル（キャプション）

表の 1 行目に、|: タイトル | の形で書きます。

記述例

|: 2026年 価格表 |
| 名前 | 価格 | 個数 |
| --- | --- | --- |
| りんご | 100円 | 3個 |

本文の区切り・合計欄（フッター）

表の途中に「-」だけの行を入れると、本文をグループに分けられます。「=」だけの行を入れると、その下が合計などを書く欄（フッター）になります。

記述例

| 名前 | 価格 | 個数 |
| --- | --- | --- |
| りんご | 100円 | 3個 |
| みかん | 120円 | 8個 |
|-----------------|
| 牛乳 | 200円 | 1本 |
|=================|
| 合計 | < | 12点 |

セルの中で改行・箇条書き（複数行のセル）

行の最後（最後の「|」の後）に「\」（バックスラッシュ）を書くと、次の行と 1 つの行としてまとめられます。セルの中に箇条書きや複数の段落を書けます。

記述例

| プラン     | 内容                 |
| ---------- | -------------------- |
| ベーシック | - ページ数：5ページ  | \
|            | - 更新：月1回        |
| プレミアム | - ページ数：10ページ | \
|            | - 更新：月4回        |

• Windows のキーボードでは、「\」は「¥」キーで入力します。
• 何も書かない行（| | | \）を挟むと、セルの中の段落を分けられます。

注記・補足の書き方

アラート（注意書きのボックス）

引用の 1 行目に [!NOTE] などの種類を書くと、アイコン付きの注意書きになります。

記述例

> \[!NOTE\] 補足 知っておくと便利な情報です。

> \[!WARNING\] ご注意ください 作業の前に、必ずバックアップを取ってください。

※アイコンの表示は、サイトの設定によって変わります。

折りたたみ

アラートの種類の直後に「-」を付けると、クリックで開閉できる折りたたみになります。「+」を付けると、最初から開いた状態で表示されます。

記述例

> [!NOTE]- よくある質問：納期はどのくらいですか？
> 通常、ご注文から 2〜3 営業日で発送します。

> [!TIP]+ 開いた状態で表示する例
> 「+」を付けると、最初から開いています。

「よくある質問」のように、必要な人だけが読めばよい情報に便利です。

脚注

文中に [^1] のような印を書き、別の行に [^1]: 内容 で説明を書くと、ページの最後に注釈としてまとめられます。

記述例

送料は無料です[^1]。

[^1]: 北海道・沖縄を除きます。

• 印の番号は、文中に出てきた順に自動で振られます。[^送料] のように、数字以外の名前も使えます。
• 説明の行は、どこに書いてもかまいません。

囲み（カスタムコンテナ）

「:::」（コロン 3 つ）と名前を書いた行と、「:::」だけの行で囲むと、その部分がひとまとまりの囲みになります。名前には、サイトで用意されているデザインの名前（クラス名）を書きます。

記述例

:::box is-outlined
囲みの中の文章です。 **太字** や箇条書きも使えます。
:::

:::{#id .box} のように、ID やクラス名を指定することもできます。

※どんな見た目になるかは、サイトのデザイン（CSS）で決まります。

目次

単独の行に次の記号を書くと、その位置に目次が表示されます。

※目次は、サイト側の機能で表示されます。

記号をそのまま表示したいとき

Markdown の記号を、記号のまま表示したいときは、前に「\」（バックスラッシュ）を付けます。

記述例

\*アスタリスク\* をそのまま表示します。

HTML をそのまま書く

Markdown で書けない表現は、HTML のタグをそのまま書くことができます。

記述例

<img src="https://code-plus.jp/gp/wp-content/uploads/PKST615_0I9A6442_TP_V.jpg" alt="猫の画像" width="300">

表示例

まとめ（早見表）

これらの基本を押さえて、読みやすい文書作成を楽しみましょう！