Markdown記法の書き方完全ガイド｜技術文書・ブログ執筆に

エンジニアやライターの間で広く使われているMarkdown（マークダウン）。

GitHub、Notion、Qiita、Zennなど、多くのサービスがMarkdownに対応しており、覚えておくと文書作成の効率が格段に上がります。

この記事では、Markdownの基本から応用まで、実践的な書き方を解説します。

Markdownとは？

Markdownは、シンプルな記法で文書を構造化できる軽量マークアップ言語です。2004年にJohn Gruberによって考案されました。

Markdownのメリット

• 習得が簡単：HTMLより直感的な記法
• 可読性が高い：プレーンテキストでも読みやすい
• 変換が容易：HTML、PDF、Wordなどに変換可能
• バージョン管理：Gitとの相性が良い

主な使用場所

• GitHubのREADME
• 技術ブログ（Qiita、Zennなど）
• Notionやドキュメントツール
• 静的サイトジェネレーター

基本的な書き方

見出し

#の数で見出しレベルを指定します。

記法	結果	HTML相当
# 見出し1	最大の見出し	<h1>
## 見出し2	大見出し	<h2>
### 見出し3	中見出し	<h3>
#### 見出し4	小見出し	<h4>

テキストの装飾

記法	結果	用途
**太字**	太字	強調
*斜体*	斜体	やや強調
~~取り消し線~~	取り消し線	削除・訂正
`コード`	コード	インラインコード

リスト

箇条書きと番号付きリストがあります。

リンクと画像

種類	記法
リンク	[表示テキスト](URL)
画像	

応用的な記法

コードブロック

複数行のコードは、バッククォート3つで囲みます。言語名を指定するとシンタックスハイライトが効きます。

```javascript
function hello() {
  console.log("Hello, World!");
}
```

表（テーブル）

パイプ（|）とハイフン（-）で表を作成します。

| 左揃え | 中央揃え | 右揃え |
|:-------|:-------:|-------:|
| データ1 | データ2 | データ3 |

引用

>で始めると引用になります。

> これは引用文です。
> 複数行も可能です。

水平線

---または***で水平線を引けます。

GitHub Flavored Markdown

GitHubでは標準のMarkdownに加え、便利な拡張機能が使えます。

タスクリスト

- [x] 完了したタスク
- [ ] 未完了のタスク

自動リンク

URLを書くだけで自動的にリンクになります。また、#123でIssue、@usernameでユーザーにリンクできます。

絵文字

:smile:のように書くと絵文字が表示されます。

注釈（アラート）

> [!NOTE]
> 補足情報

> [!WARNING]
> 警告情報

活用シーン

📚 技術ドキュメント

README、APIドキュメント、インストールガイドなど。GitHubでは自動的にレンダリングされるため、見やすいドキュメントが簡単に作れます。

✍️ ブログ記事

Qiita、Zenn、HugoなどでMarkdownがそのまま使えます。HTMLを意識せずに構造化された記事が書けます。

📝 議事録・メモ

NotionやObsidianなどのノートアプリでMarkdown記法が使えます。箇条書きや見出しで情報を整理しやすくなります。

📧 メール・チャット

SlackやDiscordでは一部のMarkdown記法（太字、コードなど）が使えます。

きれいに書くコツ

1. 見出しレベルを飛ばさない

## 見出し2の次は### 見出し3に。#### 見出し4に飛ばすと構造が崩れます。

2. 空行を適切に入れる

見出しの前後、段落の間には空行を入れると読みやすくなります。

3. リストのインデントを揃える

ネストしたリストはスペース2つまたは4つでインデントします。一貫性を保ちましょう。

4. コードには言語を指定

コードブロックには必ず言語名を指定すると、シンタックスハイライトが効いて読みやすくなります。

5. 目次を活用

長い文書では、見出しへのリンクで目次を作ると読者に親切です。