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/)

画像はリンクの前に ! を付けた形です。代替テキストは画像が表示できないときに表示され、スクリーンリーダーや検索エンジンにも内容を伝えます。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 として保存して共有したりできます。