Chapter 06 / 10

引用块、分隔线与 HTML

块级引用、水平分隔线与内嵌 HTML 的使用规则

块级引用（Blockquote）

用 > 前缀创建引用块，常用于引述他人话语、警告信息、注意事项：

源码
> 这是一段引用文字。
>
> 这是引用的第二段。
渲染效果
这是一段引用文字。

这是引用的第二段。

多级嵌套引用

源码
> 一级引用
>
>> 二级引用（嵌套）
>>
>>> 三级引用
渲染效果
一级引用
二级引用（嵌套）
三级引用

引用块中嵌套其他元素

引用块内部可以使用完整的 Markdown 语法：

> **注意：** 这是一段重要说明。
>
> - 第一点
> - 第二点
>
> ```python
> print("Hello")
> ```
TIP虽然原生 Markdown 只有 > 引用块，但很多平台（GitHub、Obsidian）支持扩展的告警块（Alert/Callout）。GitHub 从 2023 年起支持：> [!NOTE]、> [!TIP]、> [!WARNING]、> [!CAUTION]。

GitHub 告警块（GFM Alert）

> [!NOTE]
> 这是一个信息提示。

> [!WARNING]
> 这是一个警告。

> [!CAUTION]
> 这是一个危险提示。

水平分隔线

用三个（或更多）-、* 或 _ 创建水平分隔线：

源码（多种写法等价）
---
***
___
- - -
* * *
渲染效果
WARNING注意 ---（分隔线）和 Setext 标题语法的区别：如果 --- 紧接在文本行后面，会被解析为 H2 标题，而不是分隔线。确保分隔线前面有空行。

内嵌 HTML

Markdown 允许直接内嵌 HTML，输出时直接透传。这在需要精细控制排版时很有用：

常见用途

<!-- 注释（不会显示在渲染结果中）-->

<!-- 居中对齐 -->
<div align="center">

![Logo](logo.png)

**项目名称**

</div>

<!-- 折叠展开块 -->
<details>
  <summary>点击展开详情</summary>

  这里是被折叠的内容。

</details>

<!-- 图片尺寸控制 -->
<img src="demo.png" width="400" alt="示例">

details/summary 折叠块

点击展开示例

这是折叠内容，在 GitHub README 中非常有用，适合放置安装步骤、FAQ、长段说明等。

HTML 的限制

不同渲染器对 HTML 的支持程度不同：

平台HTML 支持备注
GitHub部分支持过滤危险标签（script/iframe/style）
VS Code 预览大部分支持本地预览，较宽松
MkDocs支持可通过插件扩展
Obsidian部分支持不支持 script
INFOMarkdown 块级 HTML 元素（<div>、<table> 等）内部的 Markdown 语法不会被解析。如果要在 HTML 块内使用 Markdown，需要在元素间留空行。

小结