Markdown（マークダウン）は、テキストに少し記号を加えるだけで、見出し・リスト・リンク・コードブロックなどを表現できる軽量な記法です。GitHub、Qiita、Zenn、note、Slack、Discord、Notion など、エンジニアでなくても日常的に使う場面が増えてきました。
覚える記号は多くなく、1ページの早見表があればほぼ困らないレベルです。この記事では、基本記法から GitHub Flavored Markdown の拡張記法まで、用途別にまとめて掲載します。
Markdownとは — 「読みやすいまま装飾できる」記法
Markdownは2004年に John Gruber 氏によって考案された記法で、当時HTMLが必須だったWebの世界に「もっと書きやすく、生のテキストでも読めるフォーマット」を持ち込みました。
例えば **強調** と書けば 強調 になり、# 見出し と書けば見出しになる。装飾用の記号がそのまま「文章の意味」を表しているので、生のテキストファイルとして読んでも内容が伝わるのが大きな特徴です。
書いた文章は専用のソフト（Markdownプロセッサ）でHTMLや別形式に変換されます。本サイトの Markdownプレビューツール を使えば、書きながら結果を確認できます。
見出し
行の先頭に # を1〜6個並べることで、h1〜h6の見出しを表現できます。# と文字の間には半角スペースを入れます。
# 大見出し— h1（記事タイトルに使う）## 中見出し— h2（章の見出し）### 小見出し— h3（節の見出し）#### 〜 ######— h4〜h6（細かい階層に使うが、深くしすぎないのがコツ）
実用上は h1〜h3 までで十分です。記事1本に対して h1 は1つ、h2 が章立て、h3 が章の中の節、という構造を意識すると読みやすくなります。
強調・斜体・打ち消し
**強調**または__強調__→ 強調*斜体*または_斜体_→ 斜体***強調と斜体***→ 強調と斜体~~打ち消し線~~→打ち消し線
日本語の場合、文字の前後にスペースを入れずに記号を使うと、サービスによっては装飾が反映されないことがあります（特に古いMarkdownプロセッサ）。困ったときは **こちら** のように前後にスペースを入れると確実です。
リンクと画像
リンク
[表示テキスト](URL) の形で書きます。
- 例：
[TegaruTools](https://tegarutools.com/) - 結果：TegaruTools
タイトル属性を付ける場合は [テキスト](URL "ホバー時のタイトル") のように書きます。
画像
 でリンクと同じ書式の頭にビックリマーク。
- 例：
代替テキスト（alt）は、画像が表示できなかった時に代わりに表示される文字列です。アクセシビリティの観点からも、可能なら入力する習慣を付けてください。
リスト
箇条書きリスト
行頭に -、*、+ のいずれかを置き、半角スペースを1つ入れて文章を書きます（どれを使ってもOK、混在も可）。
- 項目1
- 項目2
- サブ項目（インデント半角2スペースで入れ子）
- サブ項目
- 項目3
番号付きリスト
行頭に 1.、2.、...と数字を書きます。実は番号自体は何でも良く、すべて 1. でも結果は1、2、3...と自動で振られます。
- 一つ目
- 二つ目
- 三つ目
コード
インラインコード
文中にコードを埋め込むときは、バッククォート ` で囲みます。
- 例：
関数 `map` は配列の各要素を変換します。
コードブロック
複数行のコードは、行頭に半角バッククォートを3つ並べて囲みます。
```js のように言語名を入れると、対応サービスでシンタックスハイライトされます。GitHub・Qiita・Zenn・Slack いずれも対応しています。
引用
行頭に > を置くと、引用ブロックになります。
これは引用です。複数行の場合は、各行の先頭に
>を置きます。
書籍・記事の引用、または「補足説明」「注意書き」など、本文と区別したい内容を入れる時に便利です。
テーブル（表）
テーブルは縦線 | で列を区切り、見出しと本文の間にハイフン --- の行を入れます。
例：
| ヘッダ1 | ヘッダ2 || --- | --- || セル | セル |
列の整列は --- 部分で指定します。
:---— 左寄せ（デフォルト）:---:— 中央寄せ---:— 右寄せ
水平線
段落の区切りに水平線を入れたい時は、3つ以上の -、*、_ を単独行に書きます。
---***___
GitHub Flavored Markdown (GFM) の拡張記法
GitHub が独自に追加した拡張記法で、現在はQiita・Zenn・GitLab・Slack・Discord などでも広く採用されています。
チェックボックス
- [ ] 未完了タスク- [x] 完了タスク
TODOリストや、PullRequestのレビュー項目で重宝します。
シンタックスハイライト
コードブロックに言語名を指定すると、その言語に合わせた色付けがされます。例：```python、```javascript、```sql、```yaml など。
絵文字ショートコード
:smile:、:rocket:、:warning: といった書き方で絵文字を入れられます。GitHub・Slack で動作。
URL の自動リンク化
https://example.com/ のように生のURLを書くだけで、自動的にリンクとして処理されます。
取り消し線
~~取り消し~~ で 取り消し になります（前述）。
Markdownが使える主なサービス
- GitHub：README、Issue、PullRequest、Wiki、Discussions すべてMarkdown。
- Qiita / Zenn / note：日本の技術ブログ・記事サービス。
- Notion：エディタ内で
**や#を入力するとMarkdown風に変換される。 - Slack / Discord：メッセージで
*強調*、`コード`、```ブロック```が使える。 - VS Code、Typora、Obsidian：Markdownエディタとして人気。リアルタイムプレビュー付き。
書きやすくなるコツ
- プレビューを見ながら書く：本サイトの Markdownプレビューツール はブラウザ完結で、書きながら結果を確認できます。
- 段落の間は空行を入れる：改行だけだと「
」になるので、段落として区切りたい時は1行空ける。 - 記号の前後に半角スペース：日本語環境では、Markdownの記号と日本語が密着していると認識されないことがある。
- 長すぎる行は折り返す：1行が長くなりすぎると編集時に見にくい。70〜80文字で改行する習慣が読みやすい。
- HTML も使える：表現できない装飾はHTMLで書ける（ほとんどのMarkdownプロセッサが対応）。ただし依存しすぎると可搬性が落ちる。
まとめ — 1日で身に付く、一生使える記法
Markdownは、覚える記号が少なく、それぞれの意味が直感的なので、本気で取り組めば1〜2時間で十分書けるようになります。
一度身につければ、技術記事・READMEの作成、Slack/Discordでの整理された投稿、Notionでの議事録、ブログ執筆まで、あらゆるテキスト作業で時間を節約できます。Word の書式ツールバーをポチポチ押す日々から卒業して、書くことに集中できるエディタ体験を手に入れましょう。