Markdown 記法チートシート
最終更新
見出し
# のあとにスペースを入れます。記号の数で 1 から 6 までのレベルが決まります。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 見出し 1 | # Page title | 最上位の見出し、<h1> |
| 見出し 2 | ## Section | セクションの見出し、<h2> |
| 見出し 3 | ### Subsection | サブセクションの見出し、<h3> |
| 見出し 4 から 6 | #### Level 4
##### Level 5
###### Level 6 | <h4>、<h5>、<h6> |
| 見出し 1（別の書き方） | Page title
========== | <h1>、# Page title と同じ |
| 見出し 2（別の書き方） | Section
------- | <h2>、## Section と同じ |
| 閉じの # | ## Section ## | <h2>Section</h2>。末尾の # は取り除かれる |
| スペースなし | #Not a heading | ふつうの段落。# のあとのスペースは必須 |
太字、斜体、取り消し線
アスタリスクは単語の途中も含めてどこでも使えます。アンダースコアは単語の境界でしか効かないので、snake_case は入力したまま表示されます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 太字 | **bold text** | 太字、<strong>bold text</strong> |
| 太字（アンダースコア） | __bold text__ | 太字、上と同じ |
| 斜体 | *italic text* | 斜体、<em>italic text</em> |
| 斜体（アンダースコア） | _italic text_ | 斜体、上と同じ |
| 太字の斜体 | ***bold and italic*** | <em><strong>bold and italic</strong></em> |
| 単語の一部を太字 | un**believ**able | 単語の真ん中だけが太字になる |
| 単語の中のアンダースコア | snake_case_name | ふつうのテキスト、斜体にならない |
| 取り消し線（GFM） | ~~no longer true~~ | 線で消される、<del>no longer true</del> |
| 下線 | <ins>underlined</ins> | 下線付きのテキスト。Markdown には下線の記法がないので、これは HTML |
| マーカー | <mark>highlighted</mark> | <mark> タグが使えるサイトではマーカーで強調されたテキスト。Markdown にはマーカーの記法がない |
改行と段落
段落の中で Enter を1回押しても、出力では改行されません。代わりに次のどれかを使います。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 新しい段落 | First paragraph.
Second paragraph. | 2つの段落。空行で区切る |
| 改行：スペース2つ | Roses are red,
Violets are blue. | red, のあとに <br> が入った1つの段落。1行目は目に見えないスペース2つで終わっている |
| 改行：バックスラッシュ | Roses are red,\
Violets are blue. | 同じ <br> を、目に見える記号で入れる。CommonMark と GitHub で使える |
| 改行：HTML | Roses are red,<br>Violets are blue. | 同じ <br>。表のセルの中でも使える |
| 改行1つだけ | Roses are red,
Violets are blue. | 1行になる：Roses are red, Violets are blue. GitHub の issue やコメントでは改行が残るが、.md ファイルでは残らない |
| 連続した空行 | One.
Two. | 空行1つと同じ。もっと間隔をあけたいときは、<br> だけの行を入れる |
リスト
入れ子の項目は、上の項目のテキストの先頭にそろえてインデントします。- の下ならスペース2つ、1. の下ならスペース3つです。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 箇条書き | - Apples
- Pears
- Plums | 箇条書きのリスト、3つの <li> を持つ <ul> |
| ほかの記号 | * Apples
+ Pears | * と + でも箇条書きになる。記号を変えると新しいリストが始まる |
| 番号付きリスト | 1. Install
2. Configure
3. Run | 番号付きのリスト、<ol> |
| 番号をそろえない書き方 | 1. Install
1. Configure
1. Run | それでも 1、2、3 と番号が振られる。意味があるのは最初の番号だけ |
| 途中の番号から始める | 7. Seventh
8. Eighth | <ol start="7">、7 から番号が振られる |
| 入れ子のリスト | - Fruit
- Apple
- Pear
- Vegetables | 最初の項目の中にリストが入る |
| 番号付きの入れ子 | 1. Download
- Windows
- macOS
2. Install | 手順 1 の中に箇条書き、スペース3つでインデント |
| 項目の中の段落 | - First item
More about the first item.
- Second item | 最初の項目の中に2つの段落 |
| 項目の中のコード | 1. Run this:
```bash
npm install
```
2. Start the app | 手順 1 の中のコードブロック、項目のテキストにそろえてインデント |
タスクリスト（チェックボックス）
GitHub Flavored Markdown の拡張機能です。[ ] か [x] で始まるリスト項目がチェックボックスになります。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 空のチェックボックス | - [ ] Write tests | チェックの入っていないボックス |
| チェック済みのボックス | - [x] Write tests | チェックの入ったボックス。[X] でもよい |
| チェックリスト | - [x] Draft
- [ ] Review
- [ ] Publish | チェック済みのボックス1つと空のボックス2つ。GitHub の issue やプルリクエストではクリックでチェックできる |
| 入れ子のタスク | - [ ] Release
- [x] Tag the commit
- [ ] Write the notes | 最初のボックスの下に2つのサブタスク |
| スペースなし | - [] Write tests | [] Write tests と表示されるふつうの箇条書き。角カッコの中にはスペースか x が必要 |
リンク
リンクのテキストを角カッコに入れ、そのすぐあとに、間をあけずにアドレスをカッコで書きます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| インラインリンク | [Coddy](https://coddy.tech) | <a href="https://coddy.tech">Coddy</a> |
| タイトル付きリンク | [Coddy](https://coddy.tech "Learn to code") | 同じリンク。マウスを重ねるとタイトルがツールチップで表示される |
| 山カッコの URL | <https://coddy.tech> | URL そのものがリンクになる |
| URL をそのまま書く（GFM） | https://coddy.tech | GitHub などの GFM サイトではリンクになり、www. で始まるアドレスもリンクになる。厳密な CommonMark ではふつうのテキスト |
| メールアドレスのリンク | <hello@example.com> | mailto: リンク |
| 参照リンク | Read the [docs][1].
[1]: https://example.com/docs | docs が URL へのリンクになる。[1]: の行は表示されない |
| 省略形の参照リンク | See [GitHub].
[GitHub]: https://github.com | GitHub が URL へのリンクになる |
| 相対リンク | [Install guide](docs/install.md) | このファイルからの相対位置にあるファイルへのリンク。GitHub ではリポジトリ内のファイルが開く |
| 見出しへのリンク | [Jump to setup](#getting-started) | 同じページの ## Getting Started までスクロールする |
| 見出しの ID | ## Getting Started! | GitHub では ID getting-started が付く。小文字になり、スペースはハイフンに変わり、- と _ 以外の記号は取り除かれる |
| 別ファイルの見出し | [Requirements](docs/install.md#requirements) | そのファイルの該当する見出しを開く |
| URL の中のスペース | [Report](my%20report.pdf) | スペースを %20 と書くか、URL を山カッコで囲む：[Report](<my report.pdf>) |
| 新しいタブで開く | <a href="https://coddy.tech" target="_blank">Coddy</a> | Markdown にはこの記法がない。サイトが target 属性を残す場合は HTML で実現できる |
画像
画像は先頭に ! を付けたリンクです。角カッコの中のテキストは代替テキストになり、スクリーンリーダーが読み上げます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 画像 |  | <img src="cat.png" alt="A cat asleep on a sofa"> |
| タイトル付き画像 |  | 同じ画像。マウスを重ねるとツールチップが表示される |
| URL の画像 |  | ウェブから画像を読み込む |
| リンク付き画像 | [](https://coddy.tech) | クリックするとリンク先が開く画像 |
| 参照形式の画像 | ![Logo][logo]
[logo]: images/logo.png | インラインの画像と同じ。URL は下で1回だけ定義する |
| 画像のサイズ | <img src="logo.png" alt="Logo" width="200"> | 幅 200 ピクセルの画像。素の Markdown にはサイズの記法がないので、これは HTML の <img> タグ |
| 中央寄せの画像 | <p align="center">
<img src="logo.png" alt="Logo" width="200">
</p> | 中央に配置された画像。GitHub の README ファイルでよく見かける |
コードとコードブロック
バッククォートは行内のコード、バッククォート3つのフェンスはブロックを表します。コードの中では書式が一切適用されません。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| インラインコード | Run `npm install` first. | 等幅フォントの npm install、<code> として |
| コードの中のバッククォート | ``Use `git` here`` | コード Use `git` here。中身よりも多いバッククォートで囲む |
| コードブロック | ```
npm install
npm run dev
``` | 改行を保ったブロック、<pre><code> |
| シンタックスハイライト | ```python
def greet(name):
return f"Hello, {name}"
``` | 構文に色が付いた Python のブロック。よく使う名前：js、ts、python、bash、json、html、css、sql |
| チルダのフェンス | ~~~js
console.log("hi");
~~~ | バッククォートのフェンスと同じ |
| インデントによるコード | const total = 42; | 空行のあとで、スペース4つのインデントで作るコードブロック |
| 差分ブロック | ```diff
- const x = 1;
+ const x = 2;
``` | GitHub では削除された行が赤、追加された行が緑で表示される |
| ブロックの中のフェンス | ````markdown
```js
let a = 1;
```
```` | 内側のフェンスをテキストとして表示するブロック。外側のフェンスには内側より多くのバッククォートが必要 |
表
GitHub Flavored Markdown の拡張機能です。2行目の区切り行によって、1行目がヘッダーになります。区切り行のセルの数はヘッダーと同じでなければならず、違うと表になりません。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 表 | | Name | Role |
| ----- | ------ |
| Ada | Admin |
| Linus | Editor | | ヘッダー行と2つの行を持つ表 |
| 列の配置 | | Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c | | コロンで配置を指定：左寄せ、中央寄せ、右寄せ |
| 外側のパイプなし | Name | Role
--- | ---
Ada | Admin | 同じ表。行の最初と最後のパイプは省略できる |
| 列の幅 | | a | b |
|---|---|
| 1 | 2 | | 幅は内容で決まる。ハイフンの数は関係なく、パイプの位置をそろえる必要もない |
| セル内の書式 | | Command | Does |
| --- | --- |
| `git status` | Shows **changed** files | | コード、太字、リンク、画像はどれもセルの中で使える |
| セルの中のパイプ | | Operator | Meaning |
| --- | --- |
| `a \| b` | a or b | | セルには a | b と表示される。コードの中でもパイプは \| とエスケープする |
| セルの中の改行 | | Step | Notes |
| --- | --- |
| 1 | First line<br>Second line | | 1つのセルに2行。本当の改行を入れると行がそこで終わる |
| セルの結合 | <td colspan="2">Both columns</td> | Markdown の表ではセルを結合できない。colspan や rowspan を使って HTML で表を書く |
引用
各行を > で始めます。引用の中には、ほかのどんな Markdown でも入れられます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 引用 | > Simple is better than complex. | インデントされた引用、<blockquote> |
| 複数の段落 | > First paragraph.
>
> Second paragraph. | 2つの段落を持つ1つの引用。> だけの行が2つをつないでいる |
| 入れ子の引用 | > The reply
>> The original message | 引用の中の引用 |
| 中にほかの要素 | > #### Note
> - Back up first
> - Then upgrade | 引用の中の見出しとリスト |
| アラート（GitHub） | > [!NOTE]
> Requires Node 20 or later. | GitHub では色付きの Note ボックスになる。ほかの種類は [!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION] |
水平線
ハイフン、アスタリスク、アンダースコアのどれかを3つ以上だけ書いた行は、ページを横切る線になります。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 水平線 | --- | 水平線、<hr> |
| ほかの書き方 | ***
___ | さらに2本の水平線 |
| テキストのあとの水平線 | Some text
--- | 段落、続いて水平線。空行は残しておく |
| 空行なし | Some text
--- | 水平線ではなくレベル2の見出し。テキストの行の下の --- はその行に下線を引く記法になる |
脚注
GitHub、GitLab、多くの静的サイトジェネレーターで使えます。厳密な CommonMark には脚注がありません。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 脚注 | Markdown dates from 2004.[^1]
[^1]: John Gruber created it, with Aaron Swartz. | 注へのリンクになった上付きの 1。注はページの末尾に並ぶ |
| 名前付きの脚注 | See the spec.[^spec]
[^spec]: https://spec.commonmark.org | ラベルには単語も使えるが、注の番号は使われた順に 1、2、3 と振られる |
| 定義する場所 | [^1]: The text of the note. | 定義はファイルのどこに置いてもよい。表示は常に末尾 |
文字のエスケープ
記号の前にバックスラッシュを置くと、書式にならずにその記号自体が表示されます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| アスタリスクをそのまま表示 | \*not italic\* | アスタリスク付きのふつうのテキスト：*not italic* |
| # をそのまま表示 | \# Not a heading | # で始まる段落 |
| 数字とピリオド | 2024\. A good year. | 2024 から始まるリストではなく、段落 |
| 角カッコをそのまま表示 | \[not a link\](page.md) | 角カッコとカッコが入力したとおりに表示される |
| バッククォートをそのまま表示 | \` | バッククォート1つ |
| バックスラッシュをそのまま表示 | \\ | バックスラッシュ1つ |
| エスケープできる文字 | \ ` * _ {} [] () <> # + - . ! | | ASCII の記号すべて。英字や数字の前のバックスラッシュはそのまま残る |
| HTML エンティティ | © 2026 & <div> | © 2026 & <div>（テキストとして） |
| コードの中ではエスケープ不要 | `*stars*` | コード *stars* が入力どおりに表示される。コードの中ではバックスラッシュはふつうの文字 |
Markdown の中の HTML
ほとんどのレンダラーは HTML をそのまま通すので、Markdown に記法がないものはタグで補えます。GitHub は <script>、<style>、<iframe> や style 属性など、安全でない HTML を取り除きます。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| キーボードのキー | Press <kbd>Ctrl</kbd> + <kbd>C</kbd> | Ctrl と C がキーの形で表示される |
| 下付き文字と上付き文字 | H<sub>2</sub>O and x<sup>2</sup> | H₂O and x² |
| 折りたたみセクション | <details>
<summary>Show the answer</summary>
The answer is **42**.
</details> | クリックで開くセクション。空行があることで中の Markdown が表示される |
| HTML ブロックの中の Markdown | <div>
**not bold**
</div> | **not bold** が入力どおりに表示される。空行でブロックが終わるまで、HTML ブロックの中の Markdown は解釈されない |
| 文字色 | <span style="color: red">red</span> | インラインスタイルが使えるサイトでは赤い文字。GitHub は style 属性を取り除く |
コメント
Markdown にはコメントの記法がありません。表示されるページにテキストを出さないための方法が2つあります。
| 要素 | Markdown | 表示結果 |
|---|---|---|
| 非表示のコメント | [//]: # (This line is never shown) | 何も表示されない。この行はどのリンクからも使われないリンク定義なので、HTML にも出力されない |
| 別の書き方 | [comment]: <> (Also hidden) | 同じ仕組みで、何も表示されない |
| HTML コメント | <!-- TODO: add screenshots --> | ページには何も表示されないが、コメントは HTML のソースに残る |
| 複数行のコメント | <!--
This whole block
is hidden
--> | ページには何も表示されない |
| 書く位置 | Some text.
[//]: # (comment)
More text. | 2つの段落。コメントの行の前には空行が必要で、ないとテキストとして表示される |
GitHub Flavored Markdown と GitHub 独自の機能
GitHub Flavored Markdown（GFM）は、CommonMark に表、タスクリスト、取り消し線、URL の自動リンクを加えたものです。GitHub はさらに独自の機能を追加しています。
| 機能 | Markdown | 使える場所 |
|---|---|---|
| 表 | | a | b |
| --- | --- |
| 1 | 2 | | GFM：GitHub、GitLab、多くのドキュメントツール |
| タスクリスト | - [x] Done | GFM |
| 取り消し線 | ~~text~~ | GFM |
| URL の自動リンク | www.coddy.tech | GFM |
| 言語指定付きのコード | ```js
let a = 1;
``` | CommonMark と GFM。色はサイトが付ける |
| 脚注 | Text.[^1]
[^1]: Note. | GitHub と GitLab。ただし GFM の仕様には含まれない |
| 絵文字 | :rocket: :tada: | GitHub と GitLab がショートコードを絵文字に変換する |
| メンション | @octocat | GitHub：ユーザーにリンクし、通知を送る |
| issue へのリンク | #123 | GitHub：同じリポジトリの issue またはプルリクエスト 123 にリンクする |
| 図 | ```mermaid
graph LR
A --> B
``` | GitHub と GitLab が Mermaid の図を描画する |
| 数式 | $E = mc^2$
$$
\sum_{i=1}^{n} i
$$ | GitHub は LaTeX の数式を表示する。行内は $ 記号の間、ブロックは $$ の行の間 |
Markdown の記法をすべて1ページにまとめ、それぞれの表示結果を並べました。このチートシートでは、基本の記法（見出し、強調、改行、リスト、リンク、画像、コード、引用）と、GitHub Flavored Markdown の拡張機能（配置を指定できる表、タスクリスト、取り消し線、URL の自動リンク、脚注）に加えて、エスケープ、HTML、コメントを扱います。
例は CommonMark と GitHub Flavored Markdown に従っています。GitHub や GitLab、多くのドキュメントツールが土台にしているルールです。サイトによって動作が違う場合は、その行に書いてあります。入力しながら表示を確かめたいときは、例を Markdown エディター に貼り付けてください。
Markdown チートシート よくある質問
Markdown で表を作るには？
ヘッダー行をパイプで区切ったセルで書き、次にハイフンの区切り行、そのあとに1行ずつデータ行を書きます：
| Name | Role |、| --- | --- |、| Ada | Admin |。区切り行のコロンで列の配置を指定します：:--- は左寄せ、:---: は中央寄せ、---: は右寄せです。表は GitHub Flavored Markdown の機能なので、GitHub、GitLab、多くのドキュメントツールでは使えますが、厳密な CommonMark では使えません。Markdown で改行するには？
段落の中で1回改行しても、出力では無視されます。改行を入れるには、行末にスペースを2つかバックスラッシュ（
\）を置くか、<br> を書きます。新しい段落を始めるには、空行を1行入れます。GitHub の issue やコメントは例外で、そこでは1回の改行でもそのまま改行として表示されます。Markdown でコメントを書くには？
Markdown にコメントの記法はありませんが、2つの方法が使えます。前に空行を置いた独立した行に
[//]: # (your comment) と書くと、どこからも使われないリンク定義になるので、ページにも HTML にも出力されません。HTML コメント <!-- your comment --> もページには表示されませんが、HTML のソースには残るので、ソースを見れば誰でも読めます。Markdown でコードブロックを作るには？
コードの前の行と後の行に、それぞれバッククォートを3つ置きます。
```python のように開きのバッククォートのあとに言語名を付けると、シンタックスハイライトが効きます。文中のコードは、バッククォート1つずつで囲みます：`npm install`。Markdown でチェックボックスを作るには？
リスト項目を、空のボックスなら
[ ]、チェック済みなら [x] で始めます：- [ ] Review や - [x] Draft。空の角カッコの中のスペースは消さないでください。チェックボックスは GitHub Flavored Markdown の機能で、GitHub の issue やプルリクエストではクリックでチェックできます。Markdown で画像のサイズを変えるには？
素の Markdown にはサイズの記法がなく、
 は常に画像を元のサイズで表示します。代わりに <img src="image.png" alt="alt text" width="300"> のような HTML タグを使います。GitHub やほとんどのレンダラーで使えます。縦横比を保つには、幅か高さの一方だけを指定します。Markdown で見出しにリンクするには？
# を付けて見出しの ID にリンクします：[Setup](#getting-started) は ## Getting Started に移動します。GitHub は見出しのテキストを小文字にし、スペースをハイフンに変え、ハイフンとアンダースコア以外の記号を取り除いて ID を作ります。別ファイルの見出しなら、ファイル名のあとに ID を付けます：[Setup](docs/install.md#getting-started)。.md ファイルとは何ですか？
Markdown で書かれたプレーンテキストのファイルです。拡張子はふつう
.md か .markdown で、README.md は GitHub がリポジトリのトップページに表示するファイルです。どのテキストエディターでも開け、GitHub、ドキュメントサイト、Markdown ビューアーでは書式付きのテキストとして表示されます。編集しながら表示を確かめたいときは、Markdown エディター に貼り付けてください。関連リソース
他のチートシート
