Markdown の書き方:見出し・リスト・リンク・表の基本まとめ

Markdown は、プレーンテキストで「書式のある文書」を書くための記法です。#、*、- などの記号を少し加えるだけで、ビューアが見出しや太字、リストに整えてくれます。README、技術文書、ブログ、Obsidian や Notion などのノートアプリでも使われているので、一度覚えればどこでも役立ちます。

このページでは、よく使う記法を例とあわせて紹介します。書いた .md ファイルは Moread のオンライン Markdown ビューアにドロップすれば、すぐに表示を確認できます。

見出し

行頭に # を付けます。# の数が見出しのレベルで、# が最も大きく、###### まで使えます。# のあとには半角スペースを入れます。

# 文書のタイトル
## 第 1 章
### 1.1 節

タイトルの # は文書に 1 つにして、##、### で構成を分けるのが一般的です。Moread は見出しから右側の目次を自動で作ります。

段落と改行

続けて書いた行は 1 つの段落になります。新しい段落にするには空行を 1 行入れます。段落を分けずに改行したい場合は、行末に半角スペースを 2 つ入れます。

太字・斜体・取り消し線

**太字**
*斜体*
~~取り消し線~~
`インラインコード`

日本語の文章では斜体が読みにくくなりがちなので、強調には 太字 がおすすめです。

リスト

箇条書きは -、*、+ のいずれかで始めます。番号付きリストは数字とピリオドを使います。半角スペース 2〜4 個でインデントすると入れ子にできます。

- りんご
- バナナ
  - モンキーバナナ(入れ子)

1. ファイルを開く
2. テーマを選ぶ
3. 読み始める

タスクリスト

GitHub Flavored Markdown(GFM)ではチェックボックスが使え、ToDo リストに便利です。

- [x] 構成を決める
- [ ] 例を追加する
- [ ] 誤字を確認する

リンクと画像

[Moread](https://md-viewer.amemori.win/)
![代替テキスト](images/photo.png)

画像はリンクの前に ! を付けた形です。代替テキストは画像が表示できないときに表示され、スクリーンリーダーや検索エンジンにも内容を伝えます。Moread では「フォルダを開く」を使うと、文書が参照するローカル画像も表示されます。

引用

行頭に > を付けると引用になります。引用文やメモ、要点のまとめに使えます。

> 余白にこそ、景色がある。

コードブロック

コードをバッククォート 3 つで囲み、最初に言語名を書くとシンタックスハイライトされます。

```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```

Moread は数百の言語のハイライトに対応しています。javascript のコードには「▷ 実行」ボタンが付き、安全なサンドボックスで実行結果を確認できます。

表

列は | で区切り、2 行目に --- を書いて見出し行と区別します。コロンで揃え方を指定できます。

| 機能 | ショートカット | 説明 |
| :--- | :---: | ---: |
| ファイルを開く | Ctrl O | .md を選ぶ |
| 本文を検索 | Ctrl F | キーワードを探す |

:--- は左揃え、:---: は中央揃え、---: は右揃えです。

水平線とエスケープ

- か * を 3 つ以上並べると水平線になります。* や # などの記号をそのまま表示したいときは、前にバックスラッシュ \ を付けます(例:\*斜体にしない\*)。

応用:図と数式

標準の Markdown には図や数式の記法はありませんが、広く使われている 2 つの拡張があり、Moread はどちらにも対応しています。

  • Mermaid の図:テキストでフローチャートやシーケンス図、ガントチャートを描けます。Mermaid で図を書くをご覧ください。
  • LaTeX の数式:$...$ と $$...$$ で数式を書けます。Markdown で LaTeX 数式をご覧ください。

Markdown チートシート

表示 書き方
見出し # 見出し
太字 **文字**
斜体 *文字*
取り消し線 ~~文字~~
リンク [文字](URL)
画像 ![説明](パス)
箇条書き - 項目
番号付きリスト 1. 項目
タスクリスト - [ ] やること
引用 > 引用文
インラインコード `code`
水平線 ---

書き終えたら、ファイルを Moread にドロップして表示を確認したり、PDF として保存して共有したりできます。