# Markdown記法チートシート：書き方と表示例の一覧

> Markdown記法を一覧で確認できる日本語チートシート。見出し、太字、リスト、リンク、画像、コード、表、チェックボックスの書き方と表示例。

## よく使うMarkdown記法一覧

Markdownの書き方をすぐ確認できる早見表です。コピーするときは、例の `text` や `url` を自分の内容に置き換えてください。

<table>
<thead><tr><th>要素</th><th>Markdown</th><th>表示</th></tr></thead>
<tbody>
<tr><td>見出し</td><td><code># Title</code></td><td><strong>Title</strong></td></tr>
<tr><td>太字</td><td><code>**text**</code></td><td><strong>text</strong></td></tr>
<tr><td>斜体</td><td><code>*text*</code></td><td><em>text</em></td></tr>
<tr><td>打ち消し線</td><td><code>~~text~~</code></td><td><s>text</s></td></tr>
<tr><td>リンク</td><td><code>[text](url)</code></td><td><u>text</u></td></tr>
<tr><td>画像</td><td><code>![alt](img.png)</code></td><td>🖼</td></tr>
<tr><td>箇条書き</td><td><code>- item</code></td><td>• one<br>• two</td></tr>
<tr><td>番号付きリスト</td><td><code>1. item</code></td><td>1. one<br>2. two</td></tr>
<tr><td>引用</td><td><code>&gt; quote</code></td><td><span style="border-left:3px solid var(--sl-color-accent);padding-left:8px">quote</span></td></tr>
<tr><td>インラインコード</td><td><code>`code`</code></td><td><code>code</code></td></tr>
<tr><td>コードブロック</td><td><code>```lang</code></td><td><code>…code…</code></td></tr>
<tr><td>表</td><td><code>| a | b |</code></td><td>a · b</td></tr>
<tr><td>タスクリスト</td><td><code>- [ ] task</code></td><td>☑ done<br>☐ todo</td></tr>
<tr><td>区切り線</td><td><code>---</code></td><td>───</td></tr>
</tbody>
</table>

## 見出しと段落

見出しは行頭の `#` で作ります。`#` の数が増えるほど、見出しの階層が深くなります。

```markdown
# 見出し1
## 見出し2
### 見出し3
```

段落を分けるには、文章の間に空行を1行入れます。単にEnterを1回押しただけでは、表示上は同じ段落になることがあります。

## 太字・斜体・打ち消し線

```markdown
**太字**
*斜体*
~~打ち消し線~~
***太字かつ斜体***
```

打ち消し線はGitHub Flavored Markdown（GFM）で広まった拡張記法です。環境によっては対応していません。

## 箇条書きと番号付きリスト

```markdown
- 項目A
- 項目B
  - 子項目

1. 手順1
2. 手順2
3. 手順3
```

入れ子にするときは、子項目の前にスペースを入れます。必要なスペース数は表示環境によって異なるため、公開先でも確認してください。

## リンクと画像

```markdown
[リンクの文字](https://example.com)
![画像の説明](image.png)
```

画像の角括弧には、画像が表示されない場合や読み上げ時に内容が伝わる代替テキストを書きます。

## 引用

```markdown
> これは引用です。
>
> 複数の段落も引用できます。
```

## インラインコードとコードブロック

短いコマンドやファイル名はバッククォート1つで囲みます。

```markdown
`npm run build` を実行します。
```

複数行のコードは、バッククォート3つのコードフェンスで囲みます。開始側に言語名を書くと、対応する環境で色分けされます。

````markdown
```js
console.log('Hello');
```
````

## 表

```markdown
| 名前 | 状態 |
|---|---|
| 仕様書 | 完了 |
| テスト | 進行中 |
```

2行目のハイフンは必須です。列の幅をそろえる必要はありません。

## チェックボックス

```markdown
- [x] 完了した項目
- [ ] 未完了の項目
```

チェックボックスはGFMの拡張記法です。GitHubなどではタスクリストとして表示されます。

## Markdownの対応差

| 記法 | CommonMark | GitHub | 多くのエディタ |
|---|---|---|---|
| 見出し・リスト・リンク | 対応 | 対応 | 対応 |
| 表 | 拡張 | 対応 | 多くが対応 |
| 打ち消し線 | 拡張 | 対応 | 多くが対応 |
| チェックボックス | 拡張 | 対応 | 環境による |
| HTML | 対応範囲あり | 一部制限 | 環境による |

「Markdown」と呼ばれていても、すべてのサービスで表示が同じとは限りません。GitHub、VS Code、Notion、Slackなど、最終的に使う環境で確認してください。

## AIに渡すMarkdownのチェックポイント

- 見出しの階層を飛ばしすぎない。
- コードやログをコードブロックに入れる。
- 表の各列に意味の分かる見出しを付ける。
- リンクテキストを「こちら」だけにしない。
- 不要になった機密情報は打ち消し線ではなく削除する。

## 記法別の詳しい説明

- [Markdownの表](/ja/tables/)
- [Markdownのリンク](/ja/links/)
- [Markdownの画像](/ja/images/)
- [Markdownのコードブロック](/ja/code-blocks/)
- [Markdownの打ち消し線・取り消し線](/ja/strikethrough/)
- [Markdownの改行](/ja/line-breaks/)