Markdown最大的特点是易读易写,其目标是成为一种容易书写的网络语言。
Markdown 有如下显著优点:
- 纯文本,兼容性极强,可以用所有文本编辑器打开。
- 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
- Markdown 的标记语法有极好的可读性。
由于受多种text-to-HTML语言的影响,Markdown的基本语法中有一些输出效果相同的输入方法。在下面的基本语法总结中我们着重来讨论这一内容。
标题
Markdown 支持两种标题的语法,Setext和atx形式。Atx 形式在行首插入 1 到 6 个#,对应到标题 1 到 6 阶;Setext 形式是用底线的形式,利用=(最高阶标题)和-(第二阶标题)。例如:
两种方法的HTML语言输出是一致的。
输出的标题自然也是等效的:
修辞和强调
Markdown 使用星号和底线来标记需要强调的区段。两个“”包含一段文本就是粗体的语法,一个“”包含一段文本就是斜体的语法。例如:
两种字体强调方法的输出效果是一样的。
分隔符
分隔符通常用三个以上的“-”或“*”表示,如图:
输入短横线显示的分隔符通常是不显示的,输入星号显示的分隔符呈现短线分割的样式。
列表
无序列表
无序列表使用星号、加号和减号来做为列表的项目标记,三者的效果是一样的。
三者输出等效:
有序列表
在有序表中,只能使用使用数字序号加一个英文句点来标识项目,在按递增顺序输入数字序号时,输入与输出效果大致相同:
在列表标记上使用的数字并不会影响输出的 HTML 结果,上面的列表所产生的 HTML 标记为:
因此,无论输入的数字序号是多少,都不会影响输出。
图片与文字链接
Markdown 内插入链接有两种方法:替代文字和<链接地址>。有替代文字的则以替代文字的形式呈现超链接,没有则以网址的形式呈现。
引用
通常,用“>”号插入引用。
如上图所示,插入的“<>”的个数不影响引用效果。
在引用中插入标题和代码:
行内代码
如果要标记一小段行内代码,可以在代码前tab空格,也可以用反引号把它包起来(`),例如:
如果要插入规模较大的代码块,也一样可以在代码前面tab空格或者在代码的开始和末尾插入反引号,不同的是需要用多个反引号来开启和结束代码区段。代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入反引号。
表格
在Markdown 中创建表格,有简单方式和原生方式。
不管是哪种方式,基本语法都大致相同:
- 第一行为表头,第二行分隔表头和主体部分,第三行开始每一行代表一个表格行;
- 列与列之间用管道符号 “|” 隔开,原生方式的表格每一行的两边也要有管道符。
- 可在第二行指定不同列单元格内容的对齐方式,默认为左对齐,在 “-” 右边加上 “:” 为右对齐,在 “-” 两侧同时加上 “:” 为居中对齐。