Markdown 语法备注

时间:2024-02-18 09:47:26

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"

 


参考:Markdown 语法说明 (简体中文版)