Markdown(简称MD)是一种轻量级的标记语言。MD语法受到一些既有 Text-to-HTML 格式的影响,包括Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。
其语法都常用的符号组成,特定的符号约定对应特定的HTML元素标记,能实现特定的文本格式。
值得注意的是,在MarkdownPad(简称MDP)等MD编辑器中,能一键(F6)生成HTML文件,并能通过修改CSS,自定义个性化的格式表现,因而MP也是博客编辑的利器!
MD是一种文本书写的格式,因而其格式语法主要涉及常用的HTML文本元素,如h1~h6,p,strong,em,pre,code,blockquote,ol,ul,li等。当然,也包括a链接,图片链接及电邮链接等链接语法。下文将简略罗列MD常用语法:
区块元素
1. 标题
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式:前者使用不限量的 === 和 ---,即分别在文本下一行划入===或---生成最高阶标题(h1)和第二阶标题(h2);后者使用不同数量的符号 # 衔接文本,生成h1~h6的标题。
这是标题h1
================
这是标题h2
------------------
### 这是标题h3
###### 这是标题h6
2. 段落,换行,加粗,斜体
段落:常规输入生成p标签;
换行:行尾空两格或tab缩进生成br标签;
加粗:单个 * 或 _ 开头,衔接文本,对应的 * 或 _ 结尾;
斜体:一对 * 或 _ 开头,衔接文本,对应的一对 * 或 _ 结尾;
注意:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号;也可通过"\"转义,让*和\作为普通字符。
这是普通文本。 <p>这是普通文本。</p>
**这是粗体** <strong>这是粗体</strong>
**这是斜体** <em>这是斜体</em>
3. 引用,代码块,分割线
引用:在每行或段落前面添加">"符号即可,MD会自动为文本添加blockquote标签;引用可嵌套,即可在">"里面再输入">"生成引用块内的引用;引用块内可以使用其他的MD语法,如标题,列表,行内文本表现标识等。
> 这是一个引用块;
> 也可以这样写,
断行可以不用添加">"符号;
>>这是子引用。
代码块:缩进4个空格或一个tab制表符就能生成代码块,MD会用\<pre\>和\<code\>标签来把代码区块包起来。只要某一行未缩进,文本就变成普通的文本行。
这是一个标准的代码块,由pre包裹code组合而成。
注意:在代码区块中,一般的MD语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。
分割线:用三个以上的星号(*)、减号(-)、底线( _ )来建立一个分隔线,行内不能有其他东西;也可以在星号或是减号中间插入空格。
***
* * *
*******
- - -
----------------------
4. 列表
无序列表:使用星号(*)、加号(+)或减号(-)作为列表标记,标记类型为实心原点。
有序列表:使用数字+英文句点+空格作为列表标记。注意:在列表标记上使用的数字并不会影响输出的 HTML 结果,数值可相同也可不连续。
* 列表1
* 列表2
* 列表3
1. 列表1
3. 列表2
2. 列表3
区段元素
1. 链接
MD支持两种形式的链接语法:行内式和参考式两种形式。不管是哪一种,链接文字都是用 [方括号] 来标记。
行内式格式:在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可。即:[链接文本](链接网址 "title");
参考式格式:在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记。即:[链接文本][id值];[id值]:链接网址 "title";
[百度](http://www.baidu.com/)
[百度][baidu];[baidu]:http://www.baidu.com "这是百度的链接"
注意:id可以有字母、数字、空白和标点符号,但是并不区分大小写;参考式可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,如:[baidu][];[baidu]:http://www.baidu.com
2. 图片
MD使用一种和链接很相似的语法来标记图片,同样也允许两种样式:行内式和参考式。目前还无法为图片设置宽高!
行内式:![图片替代文本](图片地址 "title")
参考式:![alt 图片替代文本][id]; [id]:图片地址 "title"