Markdown は、プレーンテキストのままでも読みやすさを保ちつつ、書式付きの文章を書けるいちばんシンプルな方法です。README、ドキュメント、メモ、チャットのメッセージ、静的サイトなど、あらゆる場所で使われています。このチートシートでは、実際によく使う記法を GitHub-Flavored Markdown（GFM） を中心にまとめました。GFM は GitHub、GitLab、多くのドキュメントツール、そして Markdown Preview Editor がサポートしている方言です。
以下の例はすべて オンラインエディター に貼り付けると、結果を横に並べて確認できます。
見出し
行頭に 1〜6 個の # を書き、その後に半角スペースを入れます。# 1 つがページのタイトル、## がセクション、### がサブセクションです。
markdown# ページタイトル
## セクション
### サブセクション
#### さらに小さな見出し
# の見出しは 1 つのドキュメントに 1 つだけにし、レベルを飛ばさない（たとえば ## からいきなり #### にしない）ようにしましょう。スクリーンリーダーや検索エンジンは見出しの構造からページの内容を理解し、多くのプレビューアーは見出しから目次を作ります。
段落と改行
段落は、空行で区切られた 1 行以上のテキストです。段落内の単純な改行は無視され、行はつながって表示されます。強制的に改行するには、行末に半角スペースを 2 つ置くか、バックスラッシュを書きます。
markdown1 行目の末尾に半角スペースを 2 つ
同じ段落の 2 行目です。
空行の後から新しい段落が始まります。
強調
| 入力 | 表示 |
|---|---|
*italic* または _italic_ |
italic |
**bold** または __bold__ |
bold |
***bold italic*** |
bold italic |
~~strikethrough~~ |
|
`inline code` |
inline code |
Markdown Preview Editor を含む多くのエディターは、よく使われる拡張記法にも対応しています。==highlight==（ハイライト）、H~2~O（下付き文字）、x^2^（上付き文字）、:smile: 形式の絵文字ショートコードなどです。これらは GFM 自体には含まれないため、使う前に公開先のプラットフォームが対応しているか確認しましょう。
リスト
箇条書きには -、*、+ を、番号付きリストには数字を使います。2〜4 個のスペースでインデントすると入れ子になります。
markdown- 牛乳
- パン
- 全粒粉
- ライ麦
- コーヒー
1. リポジトリをクローンする
2. 依存関係をインストールする
3. ビルドを実行する
番号付きリストの番号は正確でなくてもかまいません。すべての行を 1. にしても 1、2、3 と表示されます。別の数字（たとえば 5.）で始めると、その番号からリストが始まります。
タスクリスト
タスクリストはリスト項目をチェックボックスに変える GFM の拡張記法です。README、リリース計画、議事録にぴったりです。
markdown- [x] 下書きを書く
- [x] スクリーンショットを追加する
- [ ] 記事を公開する
リンク
markdown[リンクテキスト](https://example.com)
[タイトル付きリンク](https://example.com "ホバー時に表示")
<https://example.com>
[インストールガイド][install]を読んでください。
[install]: https://example.com/docs/install
最後の形式は 参照リンク です。URL をドキュメントの末尾で一度だけ定義するので、長い段落も読みやすく保てます。[Setup](docs/setup.md) のような相対リンクは、同じプロジェクト内の別ファイルを指します。Markdown Preview Editor では、そのドキュメントが別のタブで開いていれば、リンクをクリックするとそのタブに切り替わります。
画像
画像はリンクの記法の前に感嘆符を付けて書きます。角かっこ内のテキストは代替テキストです。画像が見えない人のために、画像の内容を説明しましょう。
markdown
ローカル画像を参照するドキュメントをプレビューするときは、フォルダーごと開くか、画像を .md ファイルと一緒にドロップしてください。そうすればプレビューアーが相対パスを解決できます。
コード
インラインコードはバッククォート 1 つで囲みます。コードブロックはバッククォート 3 つで囲み、シンタックスハイライト用に言語名を付けます。
markdown```js
function greet(name) {
return `Hello, ${name}!`;
}
```
よく使う言語名：js、ts、python、bash、json、yaml、html、css、sql、go、rust、diff。コード自体にバッククォート 3 つが含まれる場合は、上の例のようにバッククォート 4 つで囲みます。
表
列をパイプ（|）で区切り、ヘッダーの下にハイフンの行を入れます。区切り行のコロンで配置を指定します。
markdown| 機能 | 無料 | 備考 |
|:------------|:----:|---------------------:|
| プレビュー | ✅ | 入力に合わせて更新 |
| エクスポート | ✅ | HTML, PDF, .md |
:--- は左揃え、:---: は中央揃え、---: は右揃えです。ソース上で列の幅をそろえる必要はありませんが、良いエディターなら読みやすく保てます。Markdown Preview Editor のツールバーには、表のテンプレートを挿入するボタンがあります。
引用とアラート
行頭に > を付けると引用になります。GitHub は アラート にも対応しています。これは最初の行が特別な形式の引用で、色付きのコールアウトとして表示されます。
markdown> 通常の引用です。
> [!NOTE]
> ユーザーが知っておくべき役に立つ情報。
> [!TIP]
> よりうまく進めるための便利なアドバイス。
> [!WARNING]
> すぐに注意を向けるべき緊急の情報。
アラートの種類は NOTE、TIP、IMPORTANT、WARNING、CAUTION の 5 つです。使いすぎには注意しましょう。セクションに 1 つなら目立ちますが、5 つ続くとただのノイズになります。
脚注
脚注を使うと、補足を本文から切り離せます。脚注の定義はどこに書いてもよく、ドキュメントの末尾に表示されます。
markdownMarkdown は 2004 年に誕生しました。[^1]
[^1]: John Gruber が Aaron Swartz の協力を得て作成。
水平線とエスケープ
ハイフン、アスタリスク、アンダースコアのいずれかを 3 つ以上並べた行は水平線になります：---。前に空行を入れてください。そうしないと、テキスト行の下の --- がそのテキストを見出しに変えてしまいます。
Markdown に解釈されてしまう文字をそのまま表示したいときは、バックスラッシュでエスケープします：\*not italic\*、\# not a heading、\$5（数式が有効な場合に便利）。
数式と図
技術文書では、2 つの拡張記法が定番になっています。
- 数式 — インライン数式には
$E = mc^2$、ディスプレイ数式には$$ … $$を使います。詳しくは Markdown で数式を書く方法 をご覧ください。 - 図 — 言語に
mermaidを指定したコードブロックで、フローチャート、シーケンス図、ガントチャートなどを描けます。詳しくは Markdown で Mermaid 図を描く方法 をご覧ください。
フロントマター
静的サイトジェネレーターは、ファイルの先頭にある YAML ブロックからメタデータを読み取ります。
yaml---
title: My post
date: 2026-09-27
tags: [markdown, docs]
---
良いプレビューアーは、このブロックをテキストとして表示せずに隠します。Markdown Preview Editor もそのように動作します。
次のステップ
記法を覚えるのは仕事の半分。残りの半分は、書きながら結果を確認することです。ファイルをアップロードせずに Markdown をオンラインでプレビューする方法 を読み、ドキュメントが完成したら Markdown を HTML や PDF に変換する方法 もチェックしてみてください。
よくある質問
Markdown と GitHub-Flavored Markdown の違いは何ですか？
オリジナルの Markdown（2004 年）は、見出し、強調、リスト、リンク、画像、コード、引用といった基本を定めたものです。GitHub-Flavored Markdown は CommonMark をベースにした厳密な仕様で、表、タスクリスト、取り消し線、自動リンク、脚注が追加されています。最近のツールの多くは GFM に準拠しています。
Markdown で段落を分けずに改行するには？
行末に半角スペースを 2 つ置くか、バックスラッシュ（\）を書きます。段落内の単純な改行はスペースとして扱われます。
Markdown で目次を作るには？
Markdown には目次を作る専用の記法はありません。[Tables](#tables) のように見出しのアンカーへのリンクを並べて、手動で作ることができます。多くのツールは見出しから自動でアンカーを生成します。Markdown Preview Editor では、「高度なエディター」ツールバーの 目次 ボタンで一覧を自動作成できます。
Markdown の中で HTML は使えますか？
多くのレンダラーは HTML の一部を使えますが、スクリプトやインラインのイベントハンドラーなど安全でない可能性のあるものは、各プラットフォームで取り除かれます。どこでも使えるドキュメントにするには、Markdown の記法で表現できるものはできるだけ Markdown で書きましょう。