100% プライベート — すべてブラウザ内で処理
マークダウン 引用ブロック — 複数行・ネストの例
複数行、ネスト、内部にMarkdownを混ぜる——マークダウン 引用ブロックを1層ずつ組み立てて、各レベルがライブで表示されるのを見ましょう。
MD Viewer チーム
Line one of the quote Line two of the quote
マークダウン 引用ブロックは、Markdownの引用の完全形です。複数行、複数段落、> > によるネスト、そしてあらゆるMarkdown構成要素——リスト、強調、コード——が引用ブロックの中で生きます。1行の引用がマーカー付きの文であるのに対し、マークダウン 引用ブロックは容器です。上のプレイグラウンドは複数行とネストの例をその出力の隣に読み込み、すべての編集がプレビューを即座に再レンダリングします。
容器としての性質が、マークダウン 引用ブロックを強力にし、同時に厄介にします。引用の各行がそれぞれ>マーカーを運ぶため、引用は閉じることなく段落をまたげ、引用の中の引用のためにネストでき、視覚的に引用の中に留まるリストを埋め込めます。「中にMarkdown」の例がその組み合わせを見せます。太字と箇条書きが1つのマークダウン 引用ブロックの中にあり、その一部として表示されます。
このページは、基本的な>構文を教えるマークダウン 引用ページの上級編です。ここには、ネストの規則、>のみの行の段落の挙動、マークされていない行を黙って飲み込む lazy 継続の罠、そして段落の境界を越えるときに複雑なマークダウン 引用ブロックを壊す間違いがあります。
マークダウン 引用ブロックの構文リファレンス
| 入力 | レンダリング結果 |
|---|---|
| > A > B | 2行を含む1つのマークダウン 引用ブロック |
| > A > > B | 内部に2つの段落を持つ引用 |
| > > 内側 | 1レベル深いネストされた引用ブロック |
| > > > さらに | 2レベルのネスト |
| > - 項目 | 引用ブロック内で表示されるリスト |
| > ```コード``` | 引用の中のコードフェンス |
マークダウン 引用ブロックの組み立て方
- 1
毎行マークする
マークダウン 引用ブロックの各行を>とスペースで始めます。最初の行だけではなく毎行マークすることで、引用は段落とレンダラーをまたいで堅牢になります。
- 2
> のみの行で段落を分ける
>だけの行は引用内の段落区切りです。マークダウン 引用ブロックは開いたまま、次の>行が同じ容器の新しい段落を始めます。
- 3
マーカーを重ねてネスト
> > と書いてネストします。追加のマーカーごとにマークダウン 引用ブロックが1レベル深くなり、上の「複数行」「ネスト」の例で層が積まれる感覚を掴めます。
- 4
本物のMarkdownを入れる
リスト、見出し、強調、コードフェンスは、>マーカーの後に続く限り引用ブロックの中で機能します。「中にMarkdown」の例がそのパターンを綺麗に示します。
ネストされた引用、出典の連鎖、そして構造
ネストこそ、マークダウン 引用ブロックが報われる場所です。ある研究を引用した専門家を引用する記事は2レベルです。外側の>があなたのコメントを支え、内側の> >が原文を支えます。メールスレッドは同じ構造の圧縮版で、返信レベルごとにマーカーが1つ増えます。レンダラーは段階的な字下げで視覚的なネストを保つため、読者はソースのマーカーを数えなくても、誰が何を言ったか追えます。
人を捕まえる規則は、引用内の段落境界です。完全な空行は段落を閉じますが、引用は閉じません。次の>行が同じマークダウン 引用ブロックの新しい段落として再開します。引用段落の後の、完全にマークされていないテキスト行は lazy 継続です。引用の最後の段落に折り畳まれます。この便利さは、無関係な文章がうっかり引用の後ろに続いたときバグになります。抜けたいときは空行を残し、マーカーなしで書いてください。
引用に重みがある文書——法務文書、学術執筆、キュレーションされた議論——では、マークダウン 引用ブロックはエクスポートとの相性が良いです。マークダウン PDF 変換のページはネストの字下げとバーのスタイルを保存するため、プレビューの2レベルの引用は紙の上でも2レベルの引用です。起草用のマークダウン エディタと組み合わせれば、出荷前にチェーン全体を組み立てて検証できます。
マークダウン 引用ブロックの間違い
> 引用 マークされていない行
> 引用 > マークされた行
マークされていない行は lazy 継続になり、マークダウン 引用ブロックの中に表示されます。引用したい行はすべてマークしてください。
> 外側 > 内側（マーカー1つ）
> 外側 > > 内側（マーカー2つ）
マーカー1つでは両方の行が同じレベルに留まります。マークダウン 引用ブロックをネストするには、内側の行に> >が必要です。
> > 深い > > さらに > 戻り（マーカー1つ）
> > 深い > > さらに > ネストが閉じた後の戻り
> > から>への落下は内側のレベルを閉じて外側の引用を続けます。引用の外には出ません。マークされていない空行が出る道です。
引用ブロックは容器であって装飾ではない
言葉が他人のものであるとき、または1つの単位として読まれるべきときにマークダウン 引用ブロックを使ってください。強調された箱が欲しいだけなら、注記見出しや太字のほうが軽く、ネストされた引用だけでできたページは、本当の文章を埋めてしまいます。
よくある質問
出典と仕様引用
“A block quote marker consists of 0-3 spaces of initial indent, plus (a) a character > followed by a space, or (b) a single character > not followed by a space.”
“Markdown is a text-to-HTML conversion tool for web writers.”