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