Markdown语法整理

Dec 3, 2016

 编程  jekyll  markdown

Markdown是什么

Makrdown 是一种轻量级标记语言。它允许人们“使用易读易写的 纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档”。

Markdown语法

详细的用法说明请点击

区块元素

段落和换行

一个Markdown段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行 （空行的定义是显示上看起来像是空的，便会被视为空行。比方说，某一行只包括空 格和制表符，则该行也会被视为空行）。

列表

Markdown 支持有序列表和无序列表。 无序列表使用星号、加号或是减号作为列表标记：

  • Red
  • Blue
  • Green

有序列表使用数字接着一个英文句点：

  1. Debian
  2. Arch Linux
  3. Centos

分割线

使用三个以上的星号、减号、下划线来建立一个分割线

区段元素

链接

Markdown支持两种链接语法: 行内式和参考式。

不管是哪种都要用[方括号]来标记。

行内式： 方括号后面紧接着圆括号并插入网址链接即可，如果想加上
链接的title文字，只要在网址后面，用双引号把title文字扩起来即可。

This is an example inline link.

如果你是要链接到同样主机的资源，你可以使用相对路径：

See my About page for details.

参考式: 在链接文字的括号后面再接上另一个方括号， 而在第二个方括号里面要填入用以辨识链接的标记：

This is an example reference-style link.

接着，在文件的任意处，你可以把这个标记的链接内容定义出来：

[id]: http://example.com/ “Optional Title Here”

隐式链接标记功能 让你可以省略指定链接标记

Google

Table

对其列可以使用冒号：

| Tables        | Are           | Cool  |  
| ------------- |:-------------:| -----:|  
| col 3 is      | right-aligned | $1600 |  
| col 2 is      | centered      |   $12 |  
| zebra stripes | are neat      |    $1 |

输出为：

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

每个标题单元格必须至少有3个虚线，外边框使用‘|’，列里面的元素可以使用markdown语法修饰:

Markdown | Less | Pretty  
--- | --- | ---  
*Still* | `renders` | **nicely**  
1 | 2 | 3

输出：

Markdown Less Pretty
Still renders nicely
1 2 3

图片

同样也允许两种样式： 行内式和参考式。

Inline-style:

![alt text](/static/img/shell-trash.png "Logo Title Text 1")

alt text

Reference-style:

![alt text][logo]
[logo]: /static/img/shell-trash.png "Logo Title Text 2"

alt text

Markdown 还没有办法指定图片的宽高，如果需要的话，可以使用普通的 <img>标签。

Supports emoji

:heart: :cry:

 Toc
 Tags
 Related