段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。
「由一个或多个连续的文本行组成」 这句话其实暗示了 Markdown 允许段落内的强迫换行(插入换行符),这个特性和其他大部分的 text-to-HTML 格式不一样,其它 text-to-HTML的格式会把每个换行符都转成 <br/>
标签。但如果你确实想要依赖 Markdown 来插入 <br/>
标签的话,在插入处先按入两个以上的空格然后回车。
Markdown 中 email 式的 区块引用 和多段落的 列表 在使用换行来排版的时候,不但更好用,还更方便阅读。
标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类Setext
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)
This is an H1
=============
This is an H2
-------------
展示效果如下:
This is an H1
This is an H2
任何数量的 = 和 - 都可以有效果。
类atx
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶
# 这是 H1
## 这是 H2
###### 这是 H6
可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的# 数量也不用和开头一样(行首的井字符数量决定标题的阶数):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
区块引用 Blockquotes
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
效果如下
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
效果如下
This is the first level of quoting.
This is nested blockquote.
Back to the first level.
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记。比如:
* Red
* Green
* Blue
有序列表则使用数字接着一个英文句点,无论你前面的数字是否连续,都会以第一行的数字进行递增显示。比如:
3. Bird
1. McHale
8. Parish
效果如下:
- Bird
- McHale
- Parish
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。
如果要在列表项目内放进引用,那 > 就需要缩进(4 个空格或是 1 个制表符)。
如果要放代码区块的话,该区块就需要缩进两次( 8 个空格或是 2 个制表符)。
行首出现数字-句点-空白,而你并不是需要出现列表效果,你可以在句点前面加上反斜杠,Markdown就不会显示数字-句号-空白显示。
代码区块
照原来的样子显示排版好的代码区块,Markdown 会用 <pre>
和 <code>
标签来把代码区块包起来。
在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,Markdown会自动将其装换为<pre><code>
…</pre></code>
标签。
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理。
代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。
分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -