Markdown 記法早見表 — ライブプレビュー付き

# を 1〜6 個書き、その後に半角スペースを入れます。# の見出しは 1 文書に 1 つにして、レベルを飛ばさないでください。スクリーンリーダーや目次はこの順序を頼りにしています。

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

古い「setext」形式で、レベル 1 と 2 のみ。段落の下に --- の行を置くと見出しになるため、水平線のつもりだと驚くことがあります。--- の前には空行を入れましょう。

Heading 1
=========

Heading 2
---------

空行で段落を区切ります。段落内の 1 つの改行は 1 行につなげられます（改行の項目で触れた例外を除く）。

First paragraph, which can wrap
across several source lines.

Second paragraph after a blank line.

段落を変えずに改行するには、行末に半角スペースを 2 つ、またはバックスラッシュを置きます。GitHub のコメント、Obsidian（初期設定）、Slack、Discord では、改行がすべてそのまま改行として扱われます。

Two trailing spaces  
make a break.
A trailing backslash\
works too.<br>So does an HTML br.

アスタリスクは単語の途中でも効きますが、アンダースコアは効きません（snake_case_names はそのまま表示）。そのため多くのスタイルガイドでは * が推奨されています。

**bold** or __bold__

*italic* or _italic_

***bold italic***

in**side**word works with *, not with _

各行の先頭に > を付けます。引用の中にはリストやコードなど、ほかの Markdown を何でも入れられます。

> Quoted text.
> Still quoted.
>
> > Nested quote.

-、*、+ のどれでも使えます。1 つのリストで混在させないでください（記号が変わると新しいリストになります）。

- Item
- Item
  - Nested (indent 2 spaces)
- Item

最初の番号が開始番号になり、以降の番号は無視されます。そのため全行を「1.」にしておけば、項目を並べ替えても自動で番号が振り直されます。

1. First
1. Second
1. Third

3. Starts at three
4. Four

追加の内容は、項目テキストの 1 文字目にそろえてインデントします（「1. 」の後ならスペース 3 つ）。

1. Install:

   ```sh
   npm install marked
   ```

2. Indent continuation lines
   to the item text.

バッククォート内の Markdown は解釈されません。

Run `npm test` now.

Use ``double `backticks` `` when the code contains one.

バッククォート 3 つ（または ~~~）をそれぞれ単独の行に置きます。開始フェンスの後の単語で言語を指定すると、GitHub、GitLab、Obsidian、Discord でシンタックスハイライトされます。

```js
const answer = 42;
console.log(answer);
```

const answer = 42;
console.log(answer);

元々の記法です。フェンスのほうがわかりやすく言語も指定できますが、旧 Reddit が理解できるのはインデント形式だけです。

Paragraph.

    four spaces of indent
    make a code block

four spaces of indent
make a code block

-、*、_ のいずれかを 3 つ以上、単独の行に書きます。上には空行を入れます。

Above

---

Below (also *** or ___)

山括弧の形式は CommonMark の自動リンクです。URL 内のスペースは %20 と書くか、URL 全体を <…> で囲む必要があります。

[Link text](https://freetoolsforweb.com)

[With a title](https://freetoolsforweb.com "Hover text")

[Relative link](/tools/regex-cheat-sheet)

<https://example.com>

長い URL を本文から追い出せます。定義は文書内のどこに置いてもよく、表示はされません。

Read the [spec][cm] and the [GFM spec].

[cm]: https://spec.commonmark.org/
[GFM spec]: https://github.github.com/gfm/

GitHub と GitLab では、すべての見出しに自動で ID が付きます。小文字化され、スペースはハイフンに、記号は削除されます（「## Install & Run」は #install--run になります）。Obsidian では代わりに [[#見出し]] を使います。

[Jump to tables](#md-tables)

リンクの前に ! を付けた形です。[ ] 内のテキストは代替テキストなので、画像が見えない人のために内容を説明しましょう。Markdown にはサイズ指定の記法がないため、HTML が使える環境では <img width="200"> を使います。

![Site logo](/brand/favicon.svg "Optional title")

[![Clickable image](/brand/favicon.svg)](/tools)

バックスラッシュを付けると、ASCII 記号をそのまま表示できます：\ ` * _ { } [ ] ( ) # + - . ! |

\*not italic\*  \# not a heading  1\. not a list

CommonMark では使用可能です。GitHub と GitLab は安全なサブセットのみ残し（script、style、イベントハンドラーは不可）、Slack、Discord、Reddit、Notion ではテキストとして表示されます。

Press <kbd>Ctrl</kbd> + <kbd>C</kbd>, H<sub>2</sub>O, x<sup>2</sup>.

HTML コメントはソースには残りますが、HTML が使える環境では表示されません。

Visible.

<!-- Not rendered: notes for editors -->

Also visible.

2 行目は必須で、コロンで配置を指定します。ソース上で列をそろえる必要はありません。パイプ文字そのものは \| とエスケープします。セルの結合や複数行のセルは使えません（GitHub ではセル内で <br> を使います）。

対応環境： GFM、GitLab、Obsidian、Reddit、Notion（貼り付け時）

| Left | Centre | Right |
| :--- | :----: | ----: |
| a    |   b    |     1 |
| `c`  | **d**  |    22 |

GitHub と GitLab では、Issue やプルリクエスト内のチェックボックスをクリックでき、ソースも更新されます。

対応環境： GFM、GitLab、Obsidian、Notion（[] ショートカット）

- [x] Write the draft
- [ ] Review
- [ ] Publish

チルダ 2 つならどこでも使え、GitHub は 1 つでも可。Slack は ~チルダ 1 つ~、Jira は -ハイフン- を使います。

対応環境： GFM、GitLab、Obsidian、Discord、Reddit、Notion

~~no longer true~~

GFM では URL や www. で始まるアドレスをそのまま書くとリンクになります。素の CommonMark では <…> で囲まない限りテキストのままです。

対応環境： GFM、GitLab、Obsidian、Slack、Discord、Reddit

Visit https://freetoolsforweb.com or www.example.com.

定義はどこに書いても構いません。脚注は参照された順に番号が振られ、末尾にまとめて表示されます。Obsidian にはインライン脚注 ^[このように] もあります。

対応環境： GFM、GitLab、Obsidian（CommonMark は非対応）

Markdown was created in 2004.[^1]

[^1]: By John Gruber, with Aaron Swartz.

アンカーを自分で設定します。Pandoc、PHP Markdown Extra、Hugo、Jekyll（kramdown）、MkDocs、Docusaurus が対応。GitHub と GitLab では無視されて波括弧がそのまま表示され、自動 ID が使われます。

対応環境： Pandoc、Hugo、Jekyll、MkDocs、Docusaurus（GitHub・GitLab は非対応）

### Install {#setup}

名前をコロンで囲みます。GitHub、Slack、Discord、Notion ではコロンを入力すると絵文字ピッカーが開きます。絵文字そのものを貼り付ければどこでも使えます。

対応環境： GitHub、GitLab、Slack、Discord（Obsidian はプラグインなしでは非対応、CommonMark も非対応）

Ship it :rocket: :+1: :tada:

インラインは TeX を $ で囲み、独立した数式ブロックは $$ を使います。GitHub は $`…`$ や ```math ブロックにも対応し、GitLab も同じ形式に対応しています。Notion ではインライン数式に $$…$$ を使います。

対応環境： GitHub、GitLab、Obsidian、Notion（独自記法）

Inline: $E = mc^2$

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

言語を mermaid にしたコードブロックが図になります。フローチャート、シーケンス図、クラス図、状態遷移図、ガントチャート、ER 図に対応。

対応環境： GitHub、GitLab、Obsidian、Notion（Mermaid コードブロック）

```mermaid
flowchart LR
  A[Write] --> B{Review}
  B -->|ok| C[Publish]
  B -->|changes| A
```

GitHub には NOTE、TIP、IMPORTANT、WARNING、CAUTION の 5 種類があります。GitLab（17.10 以降）も同じ記法に対応。Obsidian はさらに多くの種類に加え、独自タイトル（> [!tip] タイトル）や折りたたみ（> [!faq]-）にも対応しています。

対応環境： GitHub、GitLab 17.10 以降、Obsidian（それ以外では通常の引用）

> [!NOTE]
> Useful information.

> [!WARNING]
> Critical content that needs attention.

HTML ですが広く対応しています。中の Markdown の前後に空行を入れないと解釈されません。

対応環境： GitHub、GitLab、Obsidian、ほとんどの静的サイトジェネレーター

<details>
<summary>Click to expand</summary>

Hidden **Markdown** content.

</details>

Obsidian と一部のエディター（Typora、iA Writer）で使えます。GitHub ではイコール記号がそのまま表示されます。HTML が使える環境では <mark> を使いましょう。

対応環境： Obsidian、Typora（GitHub は非対応）

This is ==highlighted== text.