Markdown とは？基本記法から応用まで完全ガイド

Markdown（マークダウン）は、プレーンテキストで文書を書くための軽量マークアップ言語です。GitHub の README、Notion、Zenn、Qiita、ChatGPT の出力など、エンジニアや情報発信者が日常的に使うツールの多くが Markdown をサポートしています。

この記事では、Markdown の基本記法をすべて一覧にまとめ、実際に使える具体例と一緒に解説します。また、Slack・Discord・Teams などのチャットツールとの書式の違いも紹介します。

Markdown の歴史と目的

Markdown は 2004年にジョン・グルーバー（John Gruber）とアーロン・スワーツ（Aaron Swartz）によって設計されました。目標は「プレーンテキストのまま読みやすく、HTML に変換できる」書式を作ることでした。

# で見出しを、** で太字を表現するといった記法は、メールやテキストファイルで昔から使われていた慣習をベースにしています。そのため、Markdown を知らない人が見てもある程度意味が伝わります。

見出し（Heading）

行頭に # を付けることで見出しになります。# の数が多いほどレベルが下がります。

記法	HTML	表示
`# 見出し1`	`<h1>`	最大サイズの見出し
`## 見出し2`	`<h2>`	次に大きい見出し
`### 見出し3`	`<h3>`	中くらいの見出し
`#### 見出し4`	`<h4>`	小さい見出し
`##### 見出し5`	`<h5>`	さらに小さい見出し
`###### 見出し6`	`<h6>`	最小の見出し

インライン書式

記法	表示結果
`太字` または `__太字__`	太字（Bold）
`斜体` または `_斜体_`	斜体（Italic）
`*太字斜体*`	太字＋斜体
`~~取り消し線~~`	打ち消し線（Strikethrough）
`インラインコード`	等幅フォント

リンクと画像

[リンクテキスト](https://example.com)
[リンクテキスト](https://example.com "タイトル属性")

![画像の代替テキスト](https://example.com/image.png)
![画像の代替テキスト](https://example.com/image.png "タイトル")

リンクを直接記述する場合は URL をそのまま書くか、<URL> で囲みます。

https://example.com
<https://example.com>

コードブロック

バッククォートを3つ使ってコードブロックを作ります。言語名を指定するとシンタックスハイライトが適用されます。

```javascript
const greet = (name) => `Hello, ${name}!`;
console.log(greet("World"));
```

インラインコードはバッククォート1つで囲みます: `npm install`

引用（Blockquote）

> これは引用文です。
> 複数行にわたる場合はそれぞれの行頭に > を付けます。
>
> > ネストした引用も可能です。

テーブル

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A   | B   | C   |
| D   | E   | F   |

列の揃えを指定することもできます。

| 左揃え | 中央揃え | 右揃え |
|:-------|:-------:|-------:|
| A      |    B    |      C |

水平線

---
***
___

いずれも水平線（<hr>）として描画されます。

エスケープ

Markdown の特殊記号（* _ # など）をそのまま表示したい場合は、バックスラッシュ（\）でエスケープします。

\*これはアスタリスクで囲まれていますが斜体になりません\*
\# これは見出しではなく通常のテキストです

GitHub Flavored Markdown（GFM）

GitHub が定めた Markdown の拡張仕様で、以下の機能が追加されています。

テーブル記法
タスクリスト（- [x]）
取り消し線（~~text~~）
URL の自動リンク化
コードブロックのシンタックスハイライト

Zenn・Qiita・GitLab・Notion など多くのサービスも GFM に準拠した記法を採用しています。

Markdown が使える主なサービス

サービス	対応状況
GitHub / GitLab	GFM 完全対応
Notion	ほぼ GFM 対応（テーブルは GUI 操作）
Zenn / Qiita	独自拡張を含む GFM 対応
VS Code	プレビュー機能で GFM 対応
Obsidian	GFM ＋独自拡張
Slack	mrkdwn（独自書式。記法が一部異なる）
Discord	H1〜H3・太字・斜体など主要記法に対応
Microsoft Teams	H1〜H3・太字・斜体など主要記法に対応

Markdown をチャットツールに貼るときの注意点

AI（Claude・ChatGPT など）の出力や GitHub の README を Slack や Discord にコピーすると、書式が崩れることがあります。主な原因は以下のとおりです。

Slack: 太字は ** でなく *、リンクは [text](url) でなく <url|text>
Discord: [text](url) 形式のリンクが機能しない
Teams: H4〜H6 の見出しが非対応

各チャットツール向けの変換は、以下のツールで自動化できます。

Markdown ↔ 各チャットツール変換 Slack・Discord・Teams・HTML への変換をリアルタイムで実行。

ツール一覧を見る →

まとめ

Markdown は # や ** などの記号でテキストに意味を付ける軽量な書式
見出し・太字・斜体・リスト・コード・テーブルが主要な記法
GitHub Flavored Markdown（GFM）が事実上の標準として広く使われている
Slack・Discord・Teams など各チャットツールでは一部の記法が異なるため変換が必要

Markdown とは？
基本記法から応用まで完全ガイド