2013-03-12

基本语法

这是标题H1
=========
这是标题H2
---------
# 这也是标题H1
## 这是标题H2
###### 这是标题H6

文本效果有 *斜体*, _还是斜体_, **粗体**, __还是粗体__, ~~删除线~~, `等宽字体`, `inline code block`

[link text](http://rainzhao.com), auto link: http://rainzhao.com

图片 ![Alt text](/path/to/img.jpg), 如果要改变图片的显示尺寸, 需要直接用HTML img tag.

Unordered list:

* apples
    * nested one, indent one tab or 4 spaces
* oranges

Ordered list:

1. apples
2. oranges

水平线: ---

完整的markdown语法请参考:

• http://daringfireball.net/projects/markdown/syntax
• http://en.wikipedia.org/wiki/Markdown

语法效果

文本效果有 斜体, 还是斜体, 粗体, 还是粗体, 删除线, 等宽字体, inline code block

link text, auto link: http://rainzhao.com

图片

Unordered list:

• apples
  • nested one, indent one tab or 4 spaces
• oranges

Ordered list:

1. apples
2. oranges

水平线:

代码高亮

```js
//in range [min, max)
var getRandomInt = function (min, max) {
    return Math.floor(Math.random() * (max - min)) + min;
};
```

效果:

//in range [min, max)
var getRandomInt = function (min, max) {
    return Math.floor(Math.random() * (max - min)) + min;
};

表格

| header 1 | header 2 |
| -------- | -------- |
| cell 1   | cell 2   |
| cell 3   | cell 4   |

| header 1 | header 2 | header 3 |
| -------- | :------: | -------: |
| cell 1   | center 2 | align right 5 |
| cell 3   | center 4 | align right 6 |

示例:

字符转义

使用md写blog时在输出某些字符时需要做转义，markdown文档在变成internet上可以访问的html之前经过了下面几步:

1. 处理jekyll/liquid语法，{{ something }}, {% something %} 会被当作jekyll语法处理
2. 按照markdown语法将内容翻译成html tag的内容

html也有特殊字符需要转义，因此在markdown文档里需要注意3种类型的字符转义:

• jekyll特殊字符
  • {{ -----> {{
  • {% -----> {%
• html特殊字符, html有5个特殊字符，不过只有下面两个必须做转义:
  • < -----> &lt; or &#60;
  • & -----> &amp; or &#38;
• markdown特殊字符

关于html字符转义可以参考 wikipedia, 所有字符都可以做html转义，其转义后为: &# + 字符的unicode编码 + 分号

Markdown引擎会自动做相关转义，因此写文档时基本不用考虑HTML字符转义和markdown字符转义.