Markdown 支持在文档中定义引用效果。官方说明如下:
中文解释:Markdown 使用邮件风格「大括号 >」的引用声明。如果你已了解如何在邮件中引用文章,那代表你也掌握了在 Markdown 文本中引用文字的方法了。其实现方式就是在被引用的文字行开头添加「大于号 >」。
引用写法起源于电子邮件,在信件往来过程中,通过引用的形式,表现出邮件的关联性。
环境说明: 考虑到 Markdown 工具之间的不兼容,有的内容直接从页面复制粘贴到本地不会正常显示,大家学习时自己动手写是肯定没问题的。本节所有实例代码及演示效果均使用 Typora 工具完成。
2. 语法详解2.1 块引用 在 Markdown 文件中,用「大于号」开头的行会被转换为块引用。
实例 1:
这是一段普通的文本内容。
“一支穿云箭,千军万马来相见;两副忠义胆,刀山火海提命现。” —— 星仔
渲染效果如下: 实例 2:
在行首加入「大于号 >」,将其改变为块引用。
> “一支穿云箭,千军万马来相见;两副忠义胆,刀山火海提命现。” —— 星仔
渲染效果如下: 实例 3:
如果需要在块引用内的换行,可以在行尾增加两个连续的空格。
> 一支穿云箭,千军万马来相见;
> 两副忠义胆,刀山火海提命现。
> —— 星仔
渲染效果如下: 实例 4:
这一写法还可以简化成只在第一行加入引用符号。
> 一支穿云箭,千军万马来相见;
两副忠义胆,刀山火海提命现。
—— 星仔
其渲染效果与以前一样:
实例 5:
如果需要在块引用里分段,只要在块引用内增加由块引用符号开启的空行即可。
> 一支穿云箭,千军万马来相见;
>
> 两副忠义胆,刀山火海提命现。
>
> —— 星仔
渲染结果如下: 块引用会被渲染成 html 的 blockquote 标签:
"一支穿云箭,千军万马来相见;两副忠义胆,刀山火海提命现。" —— 星仔
2.2 块引用的嵌套 Markdown 的块引用是有嵌套层级概念的,即一个块引用中,可以包含新一层的块引用,类似于电子邮件的多次往复效果,又好像论坛留言的多次回复。块引用的嵌套可以通过多个连续 「大于号 “>”」实现。
实例 6:
包含嵌套的块引用。
### 块引用的嵌套
块引用的嵌套依赖于行首块引用标志 ">" 的数量。
> 这是一个块引用
>
> > 这是一个二层块引用
>
> 返回到第一层
当然我们也可以直接使用多层块引用
> > > > > > > 直接的七层块引用
渲染效果如下:
2.3 块引用内容里的其他形式 Markdown 块引用像段落一样,里面的文字同样支持类似于加粗、代码块、列表、表格等。
实例 7:
### 块引用的特殊样式
> #### 块引用里的标题
>
> 块引用里的 **重点文字**
>
> 块引用里的列表
> - 项目1
> - 项目2
> - 项目3
>
> 块引用里的表格
>
> |a|b|
> |---|---|
> |c|d|
>
> 块引用里的分割线
> ___
>
渲染结果如下:
2.4 自定义块引用的样式 如果需要定制块引用的样式,可以通过 CSS 实现。
实例 8:
### 扩展块引用的样式
> 一支穿云箭,千军万马来相见;
> 两副忠义胆,刀山火海提命现。
> —— 星仔
blockquote {
border-left: 2px dashed #333 !important;
background: linear-gradient(to bottom, #efe 0%,#fef 100%) !important;
}
渲染结果如下:
块引用的使用场景非常明确。比如在邮件中,我们使用块引用的方式表示所回信件内容,因为回信行为是相互且多次的,所以块引用也可以用于嵌套。那在文章中,我们可以将一个他人的观点、原文、某个事件等信息增加块引用效果,以增加我们文章的可靠感。
实例 9:
一篇典型的论坛评论。
### 一个典型的论坛评论
> [_BAT P99_]() 评论说:
> 大多数从业者,水平太弱⊙﹏⊙
> [同意