Markdown入門：完全初心者ガイド
はじめに
QiitaやGitHubで見かける「見やすい記事」、どうやって書いているか気になったことはありませんか？
その答えが Markdown（マークダウン） です。特別なソフトは不要で、テキストに簡単な記号を加えるだけで、見出しや太字、コードブロックなどを表現できます。この記事では、Markdownをまったく知らない方向けに基本から解説します。
Markdownとは？
Markdownとは、テキストに簡単な記号を使って文書を装飾するための書き方（記法）です。
たとえば、こう書くと…
# 見出し
**太字のテキスト**
こう表示されます：
見出し
太字のテキスト
HTMLのように複雑なタグを書かなくても、シンプルな記号だけで読みやすい文書が作れます。
どこで使われているの？
- Qiita / Zenn — 技術ブログ
- GitHub — READMEやIssue
- Notion — ドキュメント管理
- Slack / Discord — チャットの文章装飾
🟢 基本の書き方
見出し（ヘッダー）
# の数で見出しの大きさが変わります。
# 見出し1（一番大きい）
## 見出し2
### 見出し3
#### 見出し4
# と文字の間に半角スペースを入れることを忘れずに！
太字・斜体・取り消し線
**太字**
*斜体*
~~取り消し線~~
表示結果：
太字
斜体
取り消し線
組み合わせることもできます：***太字かつ斜体***
リスト
箇条書き（順序なし）：
- りんご
- みかん
- ぶどう
番号付きリスト：
1. 手順1
2. 手順2
3. 手順3
ネスト（入れ子）：
- 果物
- りんご
- みかん
- 野菜
- にんじん
半角スペース2〜4つでインデントするとネストできます。
リンク・画像
リンク：
[リンクのテキスト](https://example.com)
表示結果：リンクのテキスト
画像：
リンクの前に ! をつけると画像になります。
引用
> これは引用です。
> 複数行にわたる場合もこのように書けます。
表示結果：
これは引用です。
複数行にわたる場合もこのように書けます。
水平線
---
--- を単独の行に書くと区切り線になります。
🟡 よく使う中級記法
コード
インラインコード（文中に埋め込む）：
`git status` を実行しましょう。
表示結果：git status を実行しましょう。
コードブロック（複数行）：
```
ここにコードを書く
```
言語名を指定するとシンタックスハイライト（色分け）されます：
```python
print("Hello, World!")
```
print("Hello, World!")
表（テーブル）
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |
| D | E | F |
表示結果：
| 列1 | 列2 | 列3 |
|---|---|---|
| A | B | C |
| D | E | F |
列の揃え方：
| 左揃え | 中央揃え | 右揃え |
|:-------|:--------:|-------:|
| テキスト | テキスト | テキスト |
:の位置で揃え方を指定できます。
チェックボックス
- [x] 完了したタスク
- [ ] 未完了のタスク
- [ ] もう一つのタスク
表示結果：
- 完了したタスク
- 未完了のタスク
- もう一つのタスク
GitHubのIssueやPull Requestでよく使われます。
脚注
Markdownは便利な記法です[^1]。
[^1]: John Gruberによって2004年に考案されました。
文章の末尾に補足説明を追加できます。
🔴 知っておくと差がつく応用記法
HTMLタグの埋め込み
MarkdownはHTMLタグをそのまま書くこともできます。
<details>
<summary>クリックして展開</summary>
ここに折りたたんだ内容を書きます。
</details>
長い内容を折りたたんで表示したいときに便利です。
バックスラッシュエスケープ
記号をそのまま表示したいときは \ を前につけます。
\*アスタリスクをそのまま表示\*
\# ハッシュをそのまま表示
表示結果：*アスタリスクをそのまま表示*
絵文字
多くのMarkdown対応サービスで絵文字コードが使えます。
:smile: :thumbsup: :rocket:
📋 記法まとめチートシート
🟢 基本
| 書き方 | 表示 |
|---|---|
# テキスト |
見出し1 |
## テキスト |
見出し2 |
**テキスト** |
太字 |
*テキスト* |
斜体 |
~~テキスト~~ |
|
- テキスト |
箇条書き |
1. テキスト |
番号付きリスト |
[文字](URL) |
リンク |
 |
画像 |
> テキスト |
引用 |
--- |
水平線 |
🟡 中級
| 書き方 | 表示 |
|---|---|
`コード` |
インラインコード |
```言語名 |
コードブロック |
| 列1 | 列2 | |
テーブル |
- [x] タスク |
チェックボックス（完了） |
- [ ] タスク |
チェックボックス（未完了） |
🔴 応用
| 書き方 | 表示 |
|---|---|
<details> タグ |
折りたたみ |
\* |
記号のエスケープ |
:smile: |
絵文字 |
よくある間違いと注意点
① # の後にスペースを忘れる
#見出し ← NG
# 見出し ← OK
② 空行を入れ忘れる
Markdownでは段落の間に空行が必要です。空行がないと改行されないことがあります。
1段落目のテキスト
← ここに空行が必要
2段落目のテキスト
③ サービスによって対応記法が違う
Markdownには複数の「方言」があります。GitHubとQiitaで微妙に挙動が違うことがあるので、使いたいサービスのドキュメントも確認してみましょう。
まとめ
Markdownはシンプルな記法ですが、覚えると文章を書くスピードが大幅に上がります。まずは 太字・見出し・リスト・コード の4つだけ使ってみましょう。慣れれば残りも自然と身につきます！
この記事が役に立ったら、いいね・シェアをお願いします！