100% プライベート — すべてブラウザ内で処理
マークダウン 引用 — blockquote構文とライブプレビュー
任意の一文を打ち込むと、すぐに正しいマークダウン 引用になります。blockquote構文をそのままコピーでき、読者が見た目もライブプレビューで確認できます。
MD Viewer チーム
This is a quote.
マークダウン 引用とはブロッククォートのことです。字下げされ、視覚的に区切られたテキストブロックで、出典の引用、プルクォート、注記、抜粋に使われます。作り方は簡単で、行頭に大なり記号とスペースを置くだけです。> このように。上のプレイグラウンドはこのマークダウン 引用を即座にレンダリングし、GitHubや多くのMarkdownアプリで読者が目にするアクセントバーと字下げを表示します。
マークダウン 引用が最初に混乱させるのは、約物がタイポグラフィではなくメール返信の慣習から来ている点です。> だけで引用が始まり、> > で引用の中に引用が入り、> のみの行で引用を複数の段落に分けられます。マーカーが単語ではなく記号であるぶん、上のプレイグラウンドが役に立ちます。例のテキストを編集すると、キーを打つたびにプレビューが再渲染され、マーカーと構造の対応を、目で見て理解できます。
このページはすべてブラウザ内で動作します。アカウントもアップロードもなく、あなたが入力したマークダウン 引用は端末の中に留まります。例のチップで1行の引用と複数段落の引用を切り替え、「Markdownをコピー」で正確なソースを取得してください。以下にはblockquoteの完全なリファレンス、ネストの規則、よくある間違い、そして引用についてのよくある質問を用意しました。
マークダウン 引用の構文リファレンス
| 入力 | 結果 |
|---|---|
| > テキスト | アクセントバー付きの1段落の引用 |
| > A > > B | 2つの段落を含む1つの引用 |
| > > テキスト | 外側の引用の中にネストされた引用 |
| > - 項目 | 引用ブロック内でレンダリングされる箇条書き |
| > **太字** | 引用の中でも書式が機能する |
| > # 見出し | 引用ブロックの中に置かれる見出し |
マークダウン 引用の書き方
- 1
行を>とスペースで始める
> に続けてスペース、そして文章を入力します。このマーカーだけでマークダウン 引用が成立し、> で始まるすべての行が1つのblockquoteになります。
- 2
> のみの行で段落を分ける
マークダウン 引用の中では、> だけの行が通常のテキストにおける空行と同じ役割を果たし、段落を分割します。グループ全体は途切れない1つの引用ブロックのままです。
- 3
> > でネストし、書式を混ぜる
マーカーを重ねてネストします。> > は引用の中の引用を作ります。リスト、強調、コード、見出しはすべて引用の中で機能し続けるため、これが注記ボックスとしてのblockquoteの価値です。
- 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.”
“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).”