Markdown: マークダウンのブロック引用構文とネスト

ブロック引用により文書の説得力が高まります。専門家の意見を引用する場合でも、重要なメモを強調する場合でも、ブロック引用はその仕事に最適なツールです。

1. 学ぶこと


2. テクニカル ライティング トレーナーの実話

(1) 問題点: 引用符の誤用

ジョーダンは、技術チーム向けにドキュメント作成のワークショップを実施していましたが、ほぼ全員が間違った方法で「引用」を行っていることを発見しました。一部のテキストは手動で灰色のフォントでインデントされたり、一部のテキストは斜体になったり、他の人のテキストのスクリーンショットを貼り付けたりしていました。引用が本文に溶け込んでおり、どの部分が著者自身の言葉で、どの部分が外部情報源であるかを読者が区別することができなくなりました。

(2) 解決策: > で見積もりの​​書式を統一する

ジョーダンはチーム ルールを設定しました。引用された外部テキスト、重要なヒント、警告はすべて > ブロック引用構文を使用する必要があります。チームの lint スクリプトは、標準の引用形式をチェックします。 3 か月後、引用の一貫性は 30% から 98% に上昇しました。


3. ブロッククオートの基本

(1) 基本的な構文

ブロック引用を作成するには、行の先頭で > を使用します。

MARKDOWN
> This is a blockquote.
> This is the second line of the quote.
💡 ヒント: すべての行に > を追加するのが最も安全な方法です。一部のパーサーは、段落の先頭で単一の > もサポートしています。

MARKDOWN
> This is a blockquote paragraph with > only on the first line.
This is the continuation (supported by some parsers).
⚠️ 注: 互換性を最大限に高めるために、すべての行に > を追加してください。

(2) ブロック引用符内の空白行

ブロック引用符内の空白行にも > が必要です。

MARKDOWN
> First paragraph.
>
> Second paragraph (with a blank line and `>` in between).

▶ 例: 標準的なブロッククォートの使用法

MARKDOWN
In *The Pragmatic Programmer*, the authors point out:

> The core of software development is not writing code, but managing complexity.
> A good programmer is not the one who writes the most code, but the one who makes code clearest.
⚠️ 注: ネストのレベルが 3 を超えないでください。それを超えると可読性が急激に低下します。

▶ 例: 会話型のネストされたブロック引用符

MARKDOWN
> **Project Manager:** Can this feature go live this Friday?
>
> > **Developer:** The core functionality is ready, but some edge cases still need testing.
> >
> > > **QA Engineer:** I've run 80% of the test cases. Should have results by Wednesday.
💡 ヒント: ネストされたブロック引用符は、会話、複数レベルのコメント スレッドをシミュレートしたり、引用内の引用を表示したりする場合に最適です (学術論文など)。


5. ブロック引用符内のその他の要素

(1) ブロック引用符内の見出し

MARKDOWN
> ## Core Argument of the Quoted Material
>
> This is the main body of the quoted content.
>
> ### Sub-Argument 1
>
> Detailed explanation of the sub-argument.

(2) ブロック引用符で囲まれたリスト

MARKDOWN
> Project Requirements:
>
> - Support 1,000 concurrent users
> - Response time < 200ms
> - 99.9% availability

(3) ブロック引用符内のコード ブロック

MARKDOWN
> **Core Algorithm:**
>
> ```python
> def fibonacci(n):
>     if n <= 1:
>         return n
>     return fibonacci(n-1) + fibonacci(n-2)
> ```
>
> The above algorithm has O(2^n) time complexity and can be optimized with dynamic programming.

▶ 例: ブロック引用符に複数の要素を埋め込む

MARKDOWN
> ## Technical Design Review Results
>
> After team evaluation, we've decided to adopt a **microservice architecture**.
>
> | Approach | Scalability | Maintenance Cost |
> |:-----|:------:|:--------:|
> | Monolith | Low | Low |
> | Microservices | High | High |
>
> > Note: Microservices are suitable for teams of 10+. Small teams should start with a monolith.
💡 ヒント: ブロック引用符には、見出し、リスト、コード ブロック、表、その他ほとんどの Markdown 要素を含めることができます。これにより、ブロック引用が「単なる灰色のテキスト」から自己完結型のコンテンツ ブロックに変わります。


6. ブロッククオートとコールアウトボックス

このチュートリアル全体で使用される > 構文と > **💡 Tip:** パターンはどちらもブロック引用符ですが、目的が異なります。

タイプ 構文 外観 目的
標準ブロック引用 > text 灰色の縦棒 外部ソースの引用、対話
ヒントの吹き出し > **💡 Tip:** text 灰色のバー + アイコン 重要なヒント、重要な注意事項
警告コールアウト > **⚠️ Note:** text 灰色のバー + アイコン 警告、よくある落とし穴
MARKDOWN
> Standard blockquote: quoting an external author's viewpoint.

> **💡 Tip:** This is a tip callout—it emphasizes key information for the reader.

> **⚠️ Note:** This is a warning callout—it alerts readers to risks and helps them avoid pitfalls.
💡 ヒント: 技術文書では、外部ソースを引用する場合は標準の引用符を使用し、ヒントや警告には絵文字を強化した吹き出しを使用します。視覚的に区別できるようにしておくと、読者が意図をすぐに理解できるようになります。


7. レイアウトでの高度なブロッククォートの使用法

(1) ブロック引用符を「サイドバー」として使用する

MARKDOWN
## Key Decision

We chose PostgreSQL as our primary database.

> **Decision Rationale:**
> 1. The team has 3 years of PostgreSQL experience
> 2. The project needs complex queries and transaction support
> 3. Tight budget—PostgreSQL is open-source and free

(2) 引用符内の引用符 (レイヤーごと)

MARKDOWN
The original paper states:

> Experimental results show this method is effective.
>
> > Subsequent research further confirms:
> >
> > > After 10 independent replications, the results are consistent.
💡 ヒント: 学術文書では複数レベルの引用が一般的ですが、技術文書では 2 レベル以下に留めてください。ネストが深くなるほど、読者は迷いやすくなります。


8. 完全な例: ブロック引用符を使用した技術レビューの構成

MARKDOWN
# Architecture Review Report

## Review Conclusion

Following the architecture review meeting on June 15, 2026, the team has made the following decisions:

## Database Selection

> **Final Decision:** Adopt PostgreSQL.
>
> **Rationale:**
> - The project requires complex geospatial queries (PostGIS)
> - The team has extensive PostgreSQL experience
> - Compared to MongoDB, PostgreSQL offers more robust transaction support
>
> | Comparison | PostgreSQL | MongoDB |
> |:-------|:----------:|:-------:|
> | Transactions | ✅ ACID | ✅ Multi-doc |
> | Geospatial | ✅ PostGIS | ✅ Built-in |
> | Team Experience | 3 years | 1 year |

## Deployment Plan

> **CEO's Opinion:**
>
> > I suggest starting with a monolith and splitting it once user numbers grow.
>
> **Engineering Team's Response:**
>
> We agree with this strategy. However, the database connection layer will be an independent module to facilitate future microservice migration.

## Reminders

> **⚠️ Note:** During migration, keep the old system running simultaneously for at least 2 weeks to ensure data integrity.

期待される結果: ブロック引用符によってさまざまな参加者の意見と最終決定が明確に区別される、専門的なアーキテクチャ レビュー ドキュメント。


❓ よくある質問

Q ブロック引用とインデントの違いは何ですか?
A ブロック引用には灰色の縦棒マーカーがあり、視覚的に独立したブロックです。インデントはブロック全体を水平方向に移動するだけです。ブロック引用符を使用して、「このコンテンツは他の場所から来たものである」ことを示します。 「本文の続き」にはインデントを使用します。
Q 画像をブロック引用符に含めることはできますか?
A はい。 > ![alt](image.png) は、ブロック引用符内の画像としてレンダリングされます。ただし、ブロック引用符内の大きな画像は窮屈に感じる可能性があるため、使用は控えめにしてください。
Q ブロック引用符が長すぎて読みにくくなった場合はどうすればよいですか?
A 引用された内容を最も重要な行にトリミングしてください。長い文章を引用する必要がある場合は、自分の言葉で要約し、下部にある原文へのリンクを検討してください。
Q コールアウトとブロック引用符の違いは何ですか?
A コールアウトは基本的に、視覚的に強調するために絵文字と太字のテキストが追加されたブロック引用符です。どちらも同じ HTML <blockquote> 要素としてレンダリングされます。

📖 まとめ


📝 練習問題

  1. 基本: ブロック引用符を使用し、空行 > で区切られた少なくとも 2 つの段落を持つ短い書評を書きます。

  2. 中級: 「教師が専門家を引用し、次に生徒が教師の説明を引用する」シナリオをシミュレートする二重ネストのブロック引用を作成します。各レベルには少なくとも 2 ~ 3 行が必要です。

  3. 課題: 標準のブロック引用符 (外部ソースの引用)、警告コールアウト (⚠️ リスク アラート)、表 (アプローチの比較)、およびコード ブロック (サンプル コード) をすべてブロック引用符内で組み合わせた「技術的決定ログ」を作成し、レンダリングをテストします。

Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%