Markdownのリスト
行頭に - を書くと箇条書き、1. を書くと番号付きリストになります。入れ子、開始番号、項目の中の段落とコード、番号が振り直される原因を説明します。
要点
Markdownでリストを書くには？
箇条書きは各行の先頭に -、*、+ のいずれかと空白を書きます。番号付きリストは 1. のように数字とピリオドを書きます。項目を字下げすると、上の項目の中に入れ子になります。
Markdown
- 牛乳
- 卵
- パン
1. オーブンを予熱する
2. 生地を混ぜる
3. 30分焼く表示結果
- 牛乳
- 卵
- パン
- オーブンを予熱する
- 生地を混ぜる
- 30分焼く
リストの書き方と例
リストのルールは記号と字下げに関するものだけです。1つずつ例で確認します。
箇条書き
-、*、+ はどれも同じリストになります。1つのリストでは同じ記号を使い続けます。記号を変えると別のリストになります。
Markdown
- 旅程を決める
- 航空券を予約する
- 荷物をまとめる表示結果
- 旅程を決める
- 航空券を予約する
- 荷物をまとめる
番号付きリスト
意味を持つのは最初の番号だけで、残りは順番に振られます。すべての項目を 1. にしておくと、順番を入れ替えても番号を直す必要がありません。
Markdown
1. オーブンを予熱する
1. 生地を混ぜる
1. 30分焼く表示結果
- オーブンを予熱する
- 生地を混ぜる
- 30分焼く
ほかの番号から始める
最初の番号が開始番号になるため、途中で区切ったリストの続きから番号を振れます。
Markdown
3. 3番目の手順
4. 4番目の手順表示結果
- 3番目の手順
- 4番目の手順
入れ子のリスト
下の階層の項目は、上の項目の文字の位置まで字下げします。- の下は空白2つ、1. の下は空白3つです。
Markdown
1. 果物
- りんご
- 梨
2. 野菜
- にんじん
- オレンジ色
- 紫色表示結果
- 果物
- りんご
- 梨
- 野菜
- にんじん
- オレンジ色
- 紫色
- にんじん
項目の中の段落とコード
空行を入れてから、続きの文やコードを項目の文字の位置まで字下げします。
Markdown
1. Pandocをインストールする：
```bash
brew install pandoc
```
2. バージョンを確認する：
```bash
pandoc --version
```表示結果
-
Pandocをインストールする：
brew install pandoc -
バージョンを確認する：
pandoc --version
リストにしたくない数字
数字とピリオドで始まる行はリストになります。ピリオドの前にバックスラッシュを付けると普通の文字のままです。
Markdown
1986\. いい年だった。
1986. いい年だった。表示結果
1986. いい年だった。
- いい年だった。
各サービスでの対応状況
リストはほぼどこでも使えます。Notionなどのエディタでは、記号を入力するとその場でリストのブロックになります。
| サービス | 対応 | 補足 |
|---|---|---|
| GitHub / GitLab | 対応 | 3種類の記号、番号付きリスト、入れ子に対応し、開始番号も保持されます。 |
| Discord | 対応 | メッセージで -、*、1. のリストが使えます。 |
| Slack | 違いあり | 入力欄で * や 1. と空白を入力するとリストになります。 |
| Obsidian | 対応 | リストと入れ子に対応し、Tabキーで字下げできます。 |
| Notion | 対応 | - や 1. と空白を入力するとリストのブロックになります。 |
| Qiita / Zenn | 対応 | どちらも箇条書き、番号付き、入れ子に対応しています。 |
よくある質問
Markdownで箇条書きを書くには？
各行の先頭に
-、*、+ のいずれかと空白を書きます。どれも同じ <ul> のリストになり、1つのリストでは同じ記号を使います。番号付きリストが1から振り直されるのはなぜですか？
項目の間にある何かがリストを終わらせています。多くは、項目の下に字下げされていない文やコードです。項目の文字の位置まで字下げするか、次のリストを
4. のように続きの番号から始めます。リストを入れ子にするには？
下の階層の項目を、親の項目の文字の位置まで字下げします。
- の下は空白2つ、1. の下は空白3つです。多くのレンダラーでは空白4つでも動きます。番号付きリストの番号に意味はありますか？
意味があるのは最初の番号だけです。開始番号になり、残りは順番に振られるため、すべて
1. と書いても問題ありません。2つのリストを続けて書くには？
2つ目のリストで記号を変える（
- のあとに *）か、間に1行の文やHTMLコメント <!-- --> を入れます。リスト項目の中に段落やコードブロックを入れるには？
空行を入れて、項目の文字の位置まで字下げします。
- の下は空白2つ、1. の下は空白3つです。数字で始まる行をリストにしないためには？
ピリオドの前にバックスラッシュを付けます：
2024\. いい年だった。詰めたリストと広げたリストの違いは？
項目の間に空行がなければ詰めたリストです。どこか1か所でも項目の間に空行があると、リスト全体が広げた形になり、各項目が段落として表示されて間隔が広がります。