Markdown语法手册

Markdown 语法手册

Markdown 是一种轻量级标记语言，能将文本换成有效的XHTML(或者HTML)文档，它的目标是实现易读易写，成为一种适用于网络的书写语言。

Markdown 语法简洁明了，易于掌握，所以用它来写作是件既效率又舒服的事情。我们所熟知的和一些大型CMS，如Joomla!、Drupal等都能很好的支持Markdown。我是因为写GitHub项目库中的Readme才开始接触Markdown。

Markdown 不是想要取代 HTML，甚至也没有要和它相近，它的语法种类很少，只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来， HTML 已经很容易写了。Markdown 的理念是，能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。就这样，Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

Headers 标题：

H1

H2

H3

H4

H5

H6

另外，H1和H2还能用以下方式显示：
一级标题

二级标题

Emphasis 文本强调：

斜体 or 强调
加粗 or 加粗
粗斜体 or _粗斜体

但是，如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号：这是一段* 文本强调 *的说明示例。
如果要在文字前后直接插入普通的星号或底线，你可以用反斜线（转义符）：*this text is surrounded by literal asterisks*

Lists 列表：

Unordered 无序列表：

• 无序列表
• 子项
• 子项

• 无序列表
• 子项
• 子项

• 无序列表
• 子项
• 子项

Ordered 有序列表：

1. 第一行

2. 第二行

3. 第三行

4. 第一行

• 第二行
• 第三行

组合：

• 产品介绍（子项无项目符号）
  此时子项，要以一个制表符或者4个空格缩进

• 产品特点

  1. 特点1
  • 特点2
  • 特点3

• 产品功能

  1. 功能1
  • 功能2
  • 功能3

可有时我们会出现这样的情况，首行内容是以日期或数字开头：2013. 公司年度目标。
为了避免也被转化成有序列表，我们可以在"."前加上反斜杠（转义符）：2013. 公司年度目标。

Links 连接（title为可选项）：

Inline-style 内嵌方式：
link text

Reference-style 引用方式：
[link text][id]
[id]: https://www.mozilla.org "title text"

Relative reference to a repository file 引用存储文件：
link text

还能这样使用：
[link text][]
[link text]: http://www.reddit.com

Email 邮件：
example@example.com

Images 图片：

Inline-style 内嵌方式：

Reference-style 引用方式：
![alt text][logo]
[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "title text"

Code and Syntax Highlighting 代码和语法高亮：

标记一小段行内代码：
本文是一篇介绍Markdown的语法的文章

如果高亮的内容包含号，可以这样写： `` 包裹起来` ``

语法高亮：

    <div>Syntax Highlighting</div>

    body{font-size:12px}

    var s = "JavaScript syntax highlighting";
    alert(s);

    <?php
      echo "hello, world!";
    ?>

    s = "Python syntax highlighting"
    print s

Block Code 代码分组(代码区块)：

在该行开头缩进4个空格或一个制表符(tab)

Blockquotes 引用：

Email-style angle brackets
are used for blockquotes.

And, they can be nested.

Headers in blockquotes

• You can quote a list.
• Etc.

Hard Line Breaks 换行：

在一行的结尾处加上2个或2个以上的空格，也可以使用
标签
第一行文字，
第二行文字

Horizontal Rules 水平分割线：

---

---

---

Escape character 转义符(反斜杠)：

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠：
*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：
反斜杠 `反引号 *星号 _下划线 {}花括号 []方括号 ()括弧 #井字号 +加号 -减号 .英文句 !感叹号

转自http://www.bluesdream.com/blog/markdown-cheatsheet-syntax-manual.html