Markdown 構文ガイド：例付き完全リファレンス

Markdown 構文ガイド

Markdown は、プレーンテキストを整形された HTML に変換する軽量マークアップ言語です。2004 年に John Gruber によって作られ、ドキュメント、README ファイル、ウェブ上の技術コンテンツの標準的な記述形式になりました。

見出し

# 記号を使います。最上位レベルに 1 つ、最下位まで最大 6 つの # を使います：

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

レベルは 1 ずつ増やします — ## から #### に飛ばすと、スクリーンリーダーのユーザーを混乱させる可能性があります。

テキスト整形

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

リンク

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

画像

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

代替テキストはアクセシビリティと SEO にとって重要です — 画像の読み込みに失敗したときに表示されます。

リスト

順序なしリストには -、*、+ を使います。順序付きリストには数字を使います：

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

コード

インラインコードにはバッククォート 1 つを使います： `printf()`。

コードブロックにはバッククォート 3 つと、任意の言語識別子を使います：

```python
def greet(name):
    return f"Hello, {name}!"

対応言語：`javascript`、`python`、`html`、`css`、`json`、`bash`、`sql`、`yaml`。

## 引用ブロック

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

コールアウト、注記、外部ソースの引用によく使われます。

水平線

1 行にダッシュ、アスタリスク、またはアンダースコアを 3 つ以上：

---
***
___

テーブル

パイプとダッシュで列を定義します。コロンで配置を制御します：

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

GitHub Flavored Markdown 拡張機能

GitHub Flavored Markdown（GFM）には便利な機能が追加されています：

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM は URL も自動リンクします — www.example.com は < > で囲まなくてもクリック可能になります。

特殊文字のエスケープ

リテラルの Markdown 文字を表示するには \ を前置します：

\*This is not italic\*
\# This is not a heading

エスケープが必要な文字： \ ` * _ { } [ ] ( ) # + - . ! | ~。

Markdown プレビューオンライン

Markdown プレビューツールを使えば、Markdown をリアルタイムで記述・プレビューできます。入力するとライブプレビューが更新され、見出し、リンク、画像、コードブロック、テーブルがどのようにレンダリングされるかを正確に確認できます。