Markdown 引用ブロックジェネレーター
テキストを貼り付けるだけで、先頭記号が正しく付いた引用ブロックが手に入ります。複数行も複数段落もそのまま扱えます。処理はすべてブラウザ内で完結します。
Markdownで引用を書くには？
行頭に大なり記号と半角スペースを置いて `> 引用文` と書きます。同じ記号を付けた行が続くかぎり1つの引用ブロックにまとまり、インデントされた<blockquote>要素として表示されます。`>` を2つ重ねれば入れ子の引用になり、`>` だけの行は同じ引用の中で段落を区切ります。
> これはMarkdownの引用です。
> 次の行にも続けて書けます。
>
> これは同じ引用ブロック内の2つ目の段落です。インデントされた1つの引用ブロックとして表示され、その中に段落が2つ入ります。左端には縦線が引かれるのが一般的です。
Markdown 引用ブロックジェネレーターを使う
引用するテキスト
出力
Markdownの引用ブロック記法
引用ブロックは行内の装飾ではなく「コンテナ」です。この一点を押さえておくと、引用がどこで終わるのか、入れ子はどう書くのか、なぜ引用の中でも他のMarkdown記法が効くのかがほぼ説明できます。
基本の引用ブロック
行頭に大なり記号を1つ置くと、その行の内容が引用になります。> のあとの半角スペースは必須ではありませんが、スタイルガイドもフォーマッターも付ける前提で動きます。
> シンプルさは究極の洗練である。インデントされたテキストブロックとして表示され、HTMLでは<blockquote>要素になります。左端に縦線が引かれるのが一般的です。
複数行の引用と遅延継続
確実なのはすべての行に > を付ける書き方です。CommonMarkには遅延継続（lazy continuation）もあり、引用のすぐ下にある記号なしの行は引用に吸い込まれます。手軽ですが、空行が1つ入った瞬間に成立しなくなります。
> すべての行に明示的に > を付けます。
> これがもっとも分かりやすく安全な書き方です。
> 遅延継続も機能します：
この行には記号がありませんが、上の引用に含まれます。独立した引用ブロックが2つできます。2つ目では記号のない行が引用に吸い込まれており、これこそ全行に前置きを付けたほうがよい理由です。
1つの引用に複数の段落を入れる
完全な空行は引用ブロックを終わらせます。複数の段落を同じ引用の中に収めるには、区切りの行に > だけを置いて、コンテナが閉じないようにします。
> 引用の1つ目の段落です。
>
> 同じ引用の2つ目の段落です。1つの<blockquote>の中に<p>が2つ入ります。> だけの行を消すと、無関係な引用ブロックが2つ並ぶだけになります。
引用の入れ子
階層が1つ深くなるごとに > を1つ増やします。メールの引用返信やフォーラムのスレッドはこの形で表現されます。段落の区切り行も同じ深さにしないと、入れ子はそこで途切れます。
> 元のコメント。
>
>> 1段深い返信。
>>
>>> さらに3段目。
>
> 外側の階層に戻ります。インデントが段階的に深くなる引用が3つ並び、最後に最も外側へ戻ります。HTMLでは階層ごとに<blockquote>が入れ子になります。
引用の中で他の記法を使う
引用ブロックはコンテナなので、見出し、リスト、強調、表、フェンスコードブロックはいずれも中でそのまま機能します。条件は、どの行にも > を付けることだけです。
> ### リリースノート
>
> - エクスポート時のクラッシュを修正
> - **破壊的変更：**`--out` オプションを改名
>
> ```bash
> npm i mdutil@latest
> ```1つの引用ブロックの中に、見出しと太字を含む箇条書き、フェンスコードブロックがまとめて収まります。
出典を添える
Markdownに出典専用の記法はありません。引用の最後の段落にダッシュと著者名を書くのが慣例で、こうすると出典が引用文と一緒に扱われます。
> 未来を予測する最良の方法は、それを発明することだ。
>
> — *Alan Kay*引用文と出典が同じ引用ブロックの中に収まり、本文と出典の視覚的なつながりが保たれます。
各サービスでの対応状況
> 記号そのものはどこでも通じますが、入れ子の深さ、複数行のショートカット、独自のコールアウト拡張には無視できない差があります。公開前に確認しておく価値があります。
| プラットフォーム | 対応状況 | 備考 |
|---|---|---|
| GitHub / GitLab | 対応 | 入れ子も引用内の他の記法も動作します。GitHubには > [!NOTE] や > [!WARNING] のアラート記法もあります。 |
| Discord | 対応 | > はその行だけ、>>> はメッセージの最後までを引用します。入れ子には対応していません。 |
| Slack | 一部 | 入力欄で > は使えますが、階層はすべて1段のインデントに潰されます。 |
| Obsidian | 対応 | 入れ子に完全対応。1行目に > [!info] タイトル と書くコールアウトも使えます。 |
| Notion | 一部 | > と半角スペースを入力すると引用ブロックになりますが、引用の入れ子はできません。 |
| Qiita / Zenn | 対応 | どちらも > の引用に対応します。注意書きにはQiitaの :::note、Zennの :::message のほうが向いています。 |
Markdownで引用ブロックを作る手順
引用したいテキストを貼り付ける
上の入力欄にテキストを入力するか貼り付けます。入力した1行がそのまま引用ブロックの1行になります。
改行で構造を作る
Enterキーで改行します。各行の先頭に > が自動で付くため、文章全体が分割されずに1つの引用へまとまります。
Markdownをコピーする
コピーボタンで生成された引用を取得し、README、Issue、プルリクエスト、ノートにそのまま貼り付けられます。
プレビューで確認する
プレビュータブに切り替えて1つの引用として表示されることを確認し、入れ子の返信が必要な箇所には > を手動で足します。
よくある質問
引用ブロックと引用符「」はどう違いますか？
引用ブロックはMarkdownの記法です。> を書くと実際の<blockquote>要素が生成され、レンダラー側でインデントやスタイルが付きます。引用符は構造上の意味を持たない単なる文字です。引用部分を自分の文章と視覚的にも意味的にも切り離したいときは引用ブロック、文中の短い引用には引用符を使います。
Markdownで複数行の引用を書くには？
引用したい文章のすべての行の先頭に > を付けます。多くのパーサーは遅延継続にも対応していて、1行目だけに > を付ければ続く行も引用へ取り込まれますが、空行が現れた時点で成立しなくなります。全行に付けるのが移植性の高い書き方です。
Markdownで引用を入れ子にするには？
階層ごとに > を1つずつ増やします。2階層目は >>、3階層目は >>> です。段落の区切り行も同じ深さにする必要があり、> が1つだけの行を挟むと階層が1段目まで戻ります。入れ子が意図せず崩れる原因はたいていこれです。
1つの引用ブロックに複数の段落を入れるには？
段落の間に > だけの行を挟みます。完全な空行は引用ブロックを閉じてしまうため、空行で区切った2つの段落は、2段落を含む1つの引用ではなく別々の引用ブロックになります。
GitHubでは引用ブロックはどう表示されますか？
README、Issue、プルリクエスト、コメント、Wikiのいずれでも、左に灰色の縦線が付き文字色が抑えられた形で表示されます。GitHubはアラート記法にも対応していて、1行目が [!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION] のいずれかである引用ブロックは、色付きの注意書きとして描画されます。
DiscordでMarkdownの引用は使えますか？
使えます。> と半角スペースを置くとその行だけが引用になり、メッセージの先頭に >>> と書くとそれ以降の内容がすべて引用になります。Discordは入れ子の引用を描画しないため、>> と書いても1階層の引用の中に > の文字がそのまま残るだけです。
Markdownの引用に出典を書くには？
出典専用の記法はありません。引用ブロックの最後に、ダッシュと著者名だけの段落を置くのが一般的です。たとえば > — Alan Kay のように書きます。出典を引用ブロックの内側に置くことで、引用文との視覚的なつながりが保たれます。
引用ブロックの中にリストやコードブロック、太字を入れられますか？
入れられます。引用ブロックはブロックレベルのコンテナなので、見出し、リスト、表、フェンスコードブロック、行内の強調がそのまま動作します。条件は、リスト項目の間やコードフェンスの前後にある空行も含めて、中身のすべての行に > を付けることだけです。
引用ブロックが思ったところで終わらないのはなぜですか？
ほとんどの場合は遅延継続が原因です。引用のすぐ下の段落が空行で区切られていないと、パーサーはそれを引用の続きとみなして中へ取り込みます。最後の引用行の後に空行を入れるか、続く文章にも明示的に > を付けると、2つのブロックに分かれます。
引用ブロックの見た目は変更できますか？
Markdown側では変更できません。見た目は出力を描画する側のCSSで決まるため、GitHub、Discord、Notionではそれぞれの既定のスタイルになります。自分のサイトであればCSSでblockquote要素を指定できますし、サービスによっては色分けされたコールアウト拡張が用意されています。