Markdownの引用

引用は、> で始まる行のことです。Markdownが生まれるずっと前から、メールソフトが返信を引用するのに使ってきた記法で、まさにそこから来ました。Markdownを一度も書いたことがなくても見覚えがあるのは、そのためです。

> 書くことは、目に見える形にした思考である。
>
> — 誰か賢い人

> 引用の中には**書式**も、
> [リンク](/ja/markdown-links)も、リストも入ります。
>
> - こんなふうに
> - そしてこう
>
> > その中に入れ子の引用も。

基本

> これは引用です。

> のあとの空白は慣習で読みやすくもありますが、必須ではありません。>これも通ります。そろえておいてください。

複数行にまたがる引用は、すべての行に > を置きます。

> 引用の1行目。
> 同じ段落の2行目。

これはソフトな改行なので、2行はひとつの段落に収まります。ほかの場所と同じ規則です。

怠けた継続

Markdownは、続きの行で記号を落とすことを許しています。

> 1行目には記号があります。
そしてこの行もまだ引用の一部です。

動きます。そして罠です。誰かがその段落を編集した瞬間、あるいは道具が折り返し直した瞬間に、引用は黙って中身の半分を失います。すべての行に > を置いてください。

複数の段落

空行は引用を終わらせます。ただしその空行自体が記号を持っていれば別です。

> 引用の1つめの段落。
>
> 同じ引用の2つめの段落。

真ん中の行にぽつんと置かれた > が、2つをつないでいます。これがないと、別々の引用が2つできます。

入れ子

1段階につき記号を1つ足します。

> 外側の引用。
>
> > その中の引用。
> >
> > > さらにもうひとつ。

やりとりを重ねたメールの返信がこう見えるわけで、それだけでも知っておく価値があります。

引用の中のほかのブロック

すべての行が記号を持ってさえいれば、ほとんど何でも引用の中に置けます。

> ### 引用の中の見出し
>
> リスト：
>
> 1. ひとつめ
> 2. ふたつめ
>
> ```js
> const quoted = true
> ```

注意書き

Markdownには警告やメモの囲みのための記法がありません。ほぼ普遍的な回避策は、太字の書き出しを持つ引用です。

> **メモ**
> 行末の空白は、たいていのエディタが保存時に削ります。

> **警告**
> 閉じていないコードフェンスは、文書の残り全部を飲み込みます。

GitHubはその後、独自の注意書き記法を足しました（> [!NOTE]、> [!WARNING]）。ほかのいくつかの道具もそれを真似ています。ほかの場所ではふつうの引用として表示されるので、崩れずに劣化します。ただしGitHubの外で見た目を当てにはしないでください。

よくある間違い

怠けた継続に頼る。 最初の編集までしかもちません。すべての行に印を付けてください。

記号のない空行。 そこで引用が終わります。2段落の引用をひとつのまま保ちたいなら、空行にも > を置いてください。

引用の前に空行がない。 段落の直下の > は、処理系によってはその段落に畳み込まれます。

強調のつもりで引用を使う。 引用は「これはどこかからの引用だ」という意味です。単に重要なだけのものには太字を、あるいは見出しをはっきり付けた注意書きを使ってください。

よくある質問

Markdownで引用するには？

行を > と空白で始めます。引用のすべての行で記号を繰り返してください。段落のあいだの空行も含みます。

引用を入れ子にするには？

1段階につき > を1つ足します。> > が引用の中の引用、> > > がさらに1段階深くです。各段階のすべての行に記号を置いてください。

複数段落の引用を書くには？

段落のあいだの空行に > を置きます。本当に空の行は引用を終わらせ、新しいブロックを始めます。

引用の中にリストやコードブロックを置けますか？

はい。入れ子にする内容のすべての行に > を付けてください。コードブロックのフェンスの行も、リストの前後の空行もです。

Markdownにメモや警告の囲みはありますか？

標準にはありません。持ち運べる慣習は、**メモ** のような太字の見出しで始まる引用です。GitHubは > [!NOTE] と > [!WARNING] を足しましたが、ほかの場所ではふつうの引用として表示されます。