一个段落是由一个以上相连接的行句组成,而一个以上的空行则会切分出不同的段落(空行的定义是显示上看起来像是空行,便会被视为空行。比方说,若某一行只包含空白和 tab,则该行也会被视为空行),一般的段落不需要用空白或断行缩排。
「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫断行,这个特性和其他大部分的 text-to-HTML 格式不一样(包括 MovableType 的「Convert Line Breaks」选项),其它的格式会把每个断行都转成 <br /> 标签。
如果真的想要插入 <br /> 标签,在行尾加上两个以上的空白,然后按 enter。
是的,这确实需要花比较多功夫来插入 <br /> ,但是「每个换行都转换为 <br />」的方法在 Markdown 中并不适合, Markdown 中 email 式的 区块引言 和多段落的 列表 在使用换行来排版的时候,不但更好用,还更好阅读。
标题Markdown 支持两种标题的语法,Setext 和 atx 形式。
Setext 形式是用底线的形式,利用 = (一级标题)和 - (二级标题),例如:
This is an H1 ============= This is an H2 -------------任何数量的 = 和 - 都可以有效果。
Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 级,例如:
# This is an H1 ## This is an H2 ###### This is an H6可以选择性地「关闭」atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字数量决定标题的级别):
# This is an H1 # ## This is an H2 ## ### This is an H3 ###### BlockquotesMarkdown 使用 email 形式的区块引言,如果你很熟悉如何在 email 信件中引用,就知道怎么在 Markdown 文档中建立一个区块引言,那会看起来像是强迫断行,然后在每行的最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, > consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. > Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > > Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse > id sem consectetuer libero luctus adipiscing.Markdown 也允许只在整个段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus. > 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.引言的区块内也可以使用其他的 Markdown 语法,包括标题、列表、程序代码区块等:
> ## This is a header. > > 1. This is the first list item. > 2. This is the second list item. > > Here's some example code: > > return shell_exec("echo $input | $markdown_script");任何标准的文本编辑器都能简单地建立 email 样式的引言,例如 BBEdit ,可以选择文字后,从菜单中选择增加引言级别。
列表Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
* Red * Green * Blue等同于:
+ Red + Green + Blue也等同于:
- Red - Green - Blue有序列表则使用数字接着一个英文句点:
1. Bird 2. McHale 3. Parish很重要的一点是,在列表标记上使用的数字并不会影响输出的 HTML 结果,上面的列表所产生的 HTML 标记为:
<ol> <li>Bird</li> <li>McHale</li> <li>Parish</li> </ol>如果你的列表标记写成:
1. Bird 1. McHale 1. Parish或甚至是:
3. Bird 1. McHale 8. Parish都会得到完全相同的 HTML 输出。重点在于,你可以让 Markdown 文档的列表数字和输出的结果相同,或是懒一点,可以完全不用在意数字的正确性。
如果使用懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。
列表项目标记通常是放在最左边,但是其实也可以缩排,最多三个空白,项目标记后面则一定要接着至少一个空白或 tab。