マークダウン記法とは？書き方一覧と、AI時代に覚えるべき理由
マークダウン（Markdown）は記号だけで見出しや箇条書きを表せる記法です。# を付ければ見出し、- を付ければ箇条書き。それだけのルールで文書が構造化できます。
いま覚える理由があります。ChatGPT・Claude・GeminiといったAIはマークダウンで回答を返します。CLAUDE.mdやAGENTS.mdといったAI向けの設定ファイルもマークダウンです。AIを使うなら避けて通れない記法になりました。
基本の書き方
| やりたいこと | 書き方 | 結果 |
|---|---|---|
| 見出し | # 見出し1 ## 見出し2 |
大きさが変わる（#は6段階まで） |
| 箇条書き | - 項目 または * 項目 |
・付きのリスト |
| 番号付きリスト | 1. 項目 |
1. 2. 3. と自動で振られる |
| 太字 | **太字** |
太字 |
| 斜体 | *斜体* |
斜体 |
| リンク | [表示文字](URL) |
リンクになる |
| 画像 |  |
画像が表示される |
| インラインコード | バッククォートで囲む | コード |
| 引用 | > 引用文 |
引用の見た目になる |
| 水平線 | --- |
横線が引かれる |
コードブロック
プログラムを貼るときはバッククォート3つで囲みます。開始側に言語名を書くと色が付きます。
```python
print("Hello")
```
```bash
ls -la
```表
マークダウンで一番つまずくのが表です。2行目の区切り線が必須で、これがないと表になりません。
| 項目 | 説明 |
| --- | --- |
| A | Aの説明 |
| B | Bの説明 |
# 左寄せ・中央・右寄せ
| 左 | 中央 | 右 |
| :--- | :---: | ---: |なぜマークダウンが使われるのか
- 書きながら構造が見える：記号のまま読んでも意味が分かる
- テキストファイルなので軽い：Gitで差分が取れる。Wordのように壊れない
- どこでも変換できる：HTML・PDF・スライドに変換するツールが揃っている
- AIとの相性がいい：AIの出力がそのまま使える
マークダウンが使える主な場所
| サービス | 使える範囲 | 備考 |
|---|---|---|
| GitHub | README・Issue・Pull Request | README.md が自動で表示される |
| ChatGPT・Claude・Gemini | 回答の表示 | AIの出力はマークダウン |
| Claude Code | CLAUDE.md・AGENTS.md |
AIへの指示を書く |
| Notion | ページ全体 | 記号を打つと自動変換される |
| Slack | メッセージ | 太字・コードなど一部のみ |
| Qiita・Zenn・note | 記事本文 | 技術記事の標準 |
| Jupyter Notebook | Markdownセル | コードと説明を同じファイルに |
Claude Code の設定ファイルの書き方はClaude Code の各種MDファイル完全活用ガイド、AGENTS.mdとの使い分けはAGENTS.mdとCLAUDE.mdの違い、Jupyterでの使い方はJupyter徹底解説にまとめています。
つまずきやすい3点
1．改行が反映されない
マークダウンでは、1回の改行は無視されます。段落を分けたいときは空行を1行入れてください。
これは1行目
これは2行目 ← 同じ段落として表示される
これは1行目
これは2行目 ← 段落が分かれるどうしても同じ段落内で改行したい場合は、行末に半角スペース2つを置きます。ただし見えないので、空行で段落を分けるほうが確実です。
2．記号がそのまま表示されない
* や _ を文字として使いたいとき、記法として解釈されてしまいます。バックスラッシュでエスケープしてください。
\*これは太字になりません\*3．サービスによって書き方が違う
マークダウンには方言があります。表・チェックボックス・取り消し線などは、もともとの仕様にはなくGitHub Flavored Markdown（GFM）という拡張で追加されたものです。
| 記法 | 標準 | GFM | Slack |
|---|---|---|---|
| 見出し・箇条書き・太字 | ○ | ○ | △（太字は*太字*） |
| 表 | × | ○ | × |
| 取り消し線 | × | ○（~~文字~~） |
○（~文字~） |
| チェックボックス | × | ○（- [ ] 項目） |
× |
| コードブロックの言語指定 | × | ○ | × |
「Notionで書けたのにSlackで崩れる」のはこれが原因です。貼り付け先を意識して書いてください。
AI時代のマークダウン
ChatGPTやClaudeに「表で出して」と頼むと、マークダウンの表が返ってきます。これをそのままGitHubやNotionに貼れば表として表示されます。変換の手間がありません。
逆にAIに渡す文書もマークダウンにしておくと精度が上がります。見出しで構造が示されていると、AIが文書の階層を正しく読み取れるためです。
AIの使い分けはChatGPT・Claude・Gemini徹底比較、Claude Codeの始め方はClaude Codeとは？使い方・始め方・できることにまとめています。
よくある質問
マークダウンとHTMLは何が違いますか？
HTMLは<h1>見出し</h1>のようにタグで囲みますが、マークダウンは# 見出しと書くだけです。マークダウンは最終的にHTMLに変換されます。書く側が楽になる記法だと考えてください。
拡張子は何ですか？
.md です。.markdown も使われますが、.md が一般的です。
何で書けばいいですか？
VS Codeがおすすめです。プレビューを横に並べて確認できます。Notionのように記号を打つと即座に変換されるエディタもあります。
全部覚える必要がありますか？
ありません。見出し（#）・箇条書き（-）・太字（**）・コード（```）の4つで日常の9割は足ります。表とリンクを足せば十分です。
関連記事
AI向けの設定ファイルはCLAUDE.md活用ガイド、AIの比較はChatGPT・Claude・Gemini徹底比較をご覧ください。サイト全体をAIエージェントに案内するllms.txtの書き方と設置方法も、マークダウンで書くファイルです。コードを囲む記号「`」の正体と、言語ごとの意味は逆クォート（バッククォート）の解説記事で取り上げています。
テックジムは月額22,000円の通い放題でプログラミング教室を運営しています。東京本校（永田町）では毎週土曜にゼロから始めるPython入門講座、そしてゼロから始めるClaude Code講座を無料で開いています。どちらも説明会ではなく実際に手を動かす講座です。
まとめ
マークダウンは記号だけで文書を構造化する記法です。覚えるのは#（見出し）・-（箇条書き）・**（太字）・```（コード）の4つで足ります。
- 改行は空行で：1回の改行は無視される
- 表は区切り線が必須：2行目の
| --- |を忘れない - 方言がある：表・チェックボックスはGFM拡張。Slackでは使えない
- AIの出力はマークダウン：そのまま貼れる場所を知っておくと速い
