MD ViewerMD Viewer

100% プライベート — すべてブラウザ内で処理

マークダウン 引用 — blockquote構文とライブプレビュー

任意の一文を打ち込むと、すぐに正しいマークダウン 引用になります。blockquote構文をそのままコピーでき、読者が見た目もライブプレビューで確認できます。

MD Viewer チーム

例
Markdownソース
プレビュー

This is a quote.

マークダウン 引用とはブロッククォートのことです。字下げされ、視覚的に区切られたテキストブロックで、出典の引用、プルクォート、注記、抜粋に使われます。作り方は簡単で、行頭に大なり記号とスペースを置くだけです。> このように。上のプレイグラウンドはこのマークダウン 引用を即座にレンダリングし、GitHubや多くのMarkdownアプリで読者が目にするアクセントバーと字下げを表示します。

マークダウン 引用が最初に混乱させるのは、約物がタイポグラフィではなくメール返信の慣習から来ている点です。> だけで引用が始まり、> > で引用の中に引用が入り、> のみの行で引用を複数の段落に分けられます。マーカーが単語ではなく記号であるぶん、上のプレイグラウンドが役に立ちます。例のテキストを編集すると、キーを打つたびにプレビューが再渲染され、マーカーと構造の対応を、目で見て理解できます。

このページはすべてブラウザ内で動作します。アカウントもアップロードもなく、あなたが入力したマークダウン 引用は端末の中に留まります。例のチップで1行の引用と複数段落の引用を切り替え、「Markdownをコピー」で正確なソースを取得してください。以下にはblockquoteの完全なリファレンス、ネストの規則、よくある間違い、そして引用についてのよくある質問を用意しました。

マークダウン 引用の構文リファレンス

入力結果
> テキストアクセントバー付きの1段落の引用
> A > > B2つの段落を含む1つの引用
> > テキスト外側の引用の中にネストされた引用
> - 項目引用ブロック内でレンダリングされる箇条書き
> **太字**引用の中でも書式が機能する
> # 見出し引用ブロックの中に置かれる見出し

マークダウン 引用の書き方

  1. 1

    行を>とスペースで始める

    > に続けてスペース、そして文章を入力します。このマーカーだけでマークダウン 引用が成立し、> で始まるすべての行が1つのblockquoteになります。

  2. 2

    > のみの行で段落を分ける

    マークダウン 引用の中では、> だけの行が通常のテキストにおける空行と同じ役割を果たし、段落を分割します。グループ全体は途切れない1つの引用ブロックのままです。

  3. 3

    > > でネストし、書式を混ぜる

    マーカーを重ねてネストします。> > は引用の中の引用を作ります。リスト、強調、コード、見出しはすべて引用の中で機能し続けるため、これが注記ボックスとしてのblockquoteの価値です。

  4. 4

    コピーして再利用する

    プレイグラウンドの「Markdownをコピー」で、マークダウン 引用の正確なソースをクリップボードに取得できます。README、issue、ドキュメントにそのまま貼り付けましょう。

マークダウン 引用を使うべきとき

マークダウン 引用が適切なのは、人物・文書・過去のメッセージを引用するときです。書籍の抜粋、変更履歴のハイライト、仕様書から引き抜いた注意書き、顧客の一言の紹介。ただし引用ブロックは字下げ・着色・バー付きで視覚的に騒がしいため、強調に値するテキストだけに使ってください。2番目の段落すべてがblockquoteというページでは、信号が完全に死にます。逆に言えば、数を絞ったマークダウン 引用は読者の目を正しく止めます。

関連する2つのページが深掘りします。マークダウン 引用ブロックのページは複数行・ネストされた引用、つまり積み上がった回答、法務引用、メールスレッドに焦点を当てます。また、引用を大きな文書ワークフローに組み込むなら、マークダウンエディタは同じ構文をライブプレビューで受け付け、マークダウン PDF 変換のページは引用の字下げとバーをエクスポート結果に保持します。

マークダウン 引用のよくある間違い

「引用符で囲んだテキスト」

> 引用符で囲んだテキスト

単なる引用符は通常のテキストとして表示されます。マークダウン 引用には>マーカーが必要で、引用符は句読点を足すだけです。

>1行目 2行目(マーカーなし)

> 1行目 > 2行目

マーカーのない行は同じ段落に畳み込まれますが、複数段落の引用は壊れます。堅牢なマークダウン 引用には毎行>を付けます。

> 引用1 > 引用2

> 引用1 > > 引用2

2つの>ブロックの間の空行は、隙間のある2つの別々の引用を作ります。> のみの行を使えば両段落が1つの引用に収まります。

マークダウン 引用は自分でスタイルを当てるHTMLではない

一部のエディタは生の<blockquote> HTMLを挿入できます。Markdownでも動きますが、> マーカーより重く、HTMLを除去するレンダラーでは挙動が不定になります。上のマークダウン 引用の構文はMarkdownが通じる場所すべてで通じます。> に徹すれば、あなたの引用はあらゆるレンダラーを生き延びます。

よくある質問

出典と仕様引用

“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.”
CommonMark Specification 0.31.2
“Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).”
John Gruber, "Markdown: Syntax" (Daring Fireball, 2004)

関連するMarkdownツール