MDUtil

Markdownの引用

行頭に > を書くとその行が引用になります：> 引用文。複数段落の引用、入れ子の引用、引用の中のほかの書式、アプリが追加した引用の種類を説明します。

要点

Markdownで引用を書くには？

行頭に > と空白を書きます：> 引用文。HTMLでは <blockquote> 要素になり、通常は左に線のある字下げブロックで表示されます。引用のすべての行、段落の間の空行にも > を付けます。

Markdown
> 小さな変更をこまめに出す。
> どの変更もレビューしやすくなる。

表示結果

小さな変更をこまめに出す。 どの変更もレビューしやすくなる。

引用の書き方と例

引用の中には、段落、リスト、コード、さらに別の引用など、文書に書けるものは何でも入れられます。

複数の段落

段落の間の空行に > だけを書くと、複数の段落が1つの引用に収まります。

Markdown
> 引用の1段落目。
>
> 2段落目も引用の中です。

表示結果

引用の1段落目。

2段落目も引用の中です。

入れ子の引用

> を1つ増やすごとに1段深くなります。メールの返信と同じ形です。

Markdown
> 金曜にリリースできますか？
>
>> テストが通れば。
>>
>>> 通りました。

表示結果

金曜にリリースできますか？

テストが通れば。

通りました。

引用の中のほかの書式

見出し、リスト、太字、コードも引用の中で使えます。

Markdown
> ### 更新内容
>
> - 起動が**速く**なりました
> - `--quiet` オプションを追加

表示結果

更新内容
  • 起動が速くなりました
  • --quiet オプションを追加

引用を終える

引用の直後にある > のない行も、引用の一部になります。引用を終えるには空行を入れます。

Markdown
> この行は引用です
この行も引用です。

この段落は引用ではありません。

表示結果

この行は引用です この行も引用です。

この段落は引用ではありません。

GitHubのアラート

1行目が [!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION] の引用は、GitHubではアイコン付きの色付きボックスになります。ほかのレンダラーでは普通の引用です。

Markdown
> [!NOTE]
> 読者に知っておいてほしい情報。

> [!WARNING]
> すぐに対応が必要な情報。

GitHubだけの書き方です。ほかのMarkdownアプリでは表示が異なるため、プレビューはありません。

Obsidianのコールアウト

Obsidianでは任意の種類名とタイトルが使えます。種類のあとに - を付けると折りたたまれた状態で表示されます。

Markdown
> [!tip] ショートカット
> Ctrl+Pでコマンドパレットを開きます。

> [!faq]- 折りたためますか？
> はい、これは最初から折りたたまれています。

Obsidianだけの書き方です。ほかのMarkdownアプリでは表示が異なるため、プレビューはありません。

各サービスでの対応状況

> の引用はほぼどこでも使えます。チャットツールとNotionには独自のルールがあります。

サービス対応補足
GitHub / GitLab対応ファイル、Issue、コメントで使えます。GitHubには > [!NOTE] などのアラートもあります。
Discord違いあり> は1行、>>> はメッセージのそれ以降すべてを引用します。
Slack対応行頭の > で引用になります。
Obsidian対応引用が使え、> [!note] でコールアウトになります。
Notion違いあり" と空白で引用、> と空白ではトグルリストになります。
Qiita / Zenn対応どちらも > の引用と入れ子に対応しています。

よくある質問

複数行の引用はどう書きますか？

すべての行の先頭に > を付けます。段落が複数あるときは、段落の間の空行にも > だけを書くと引用が途切れません。

引用を終えるには？

引用のあとに空行を入れます。引用の直後にある > のない行は、引用の一部として扱われます。

引用は入れ子にできますか？

できます。1段ごとに > を1つ増やします。>> は引用の中の引用です。

引用元を書くには？

Markdownに引用元の記法はありません。> — 夏目漱石 のように引用の中に1行で書くか、HTMLが使える環境では <cite> タグを使います。

GitHubのアラートとは何ですか？

1行目が [!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION] の引用です。GitHubではアイコン付きの色付きボックスで表示され、ほかのレンダラーでは普通の引用になります。

Discordで引用するには？

> と空白で1行を、>>> と空白でメッセージのそれ以降すべてを引用します。

Obsidianのコールアウトはどう書きますか？

引用の先頭に > [!tip] タイトル のように角括弧で種類を書きます。> [!tip]- のように種類のあとに - を付けると折りたたまれます。

リストの中に引用を入れるには？

> を項目の文字の位置まで字下げします。- 項目 の次の行に > 引用文 と書きます。