Markdown：syntax

概述

Markdown 的目标是实现「易读易写」。不过最需要强调的便是它的可读性。 一份使用 Markdown 格式撰写的文档应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。 因此 Markdown 的语法全由标点符号所组成，并经过严谨慎选，是为了让它们看起来就像所要表达的意思。 像是在文字两旁加上星号，看起来就像强调。 Markdown 的列表看起来，嗯，就是列表。假如你用过电子邮件，区块引言看起来就真的像是引用一段文字。

一、 标题

使用井号代表一级标题，以此类推，总共支持六级标题，即：6个#，例如以下：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、列表

列表格式也很常用，在 Markdown 中，你只需要在文字前面加上一些符号就可以了，例如： 无序和有序分别显示效果：

使用-的效果如下：

  • 列表一
  • 列表二
  • 列表三

或者使用+，效果如下：

  • 列表一
  • 列表二
  • 列表三

或者使用*，效果如下：

  • 列表一
  • 列表二
  • 列表三

或者使用1，2，3....序列号，效果如下：

  1. 列表一
  2. 列表二
  3. 列表三

注：-、1.和文本之间要保留一个字符的空格。

三、链接图片

在 Markdown 中，插入链接不需要其他按钮，你只需要使用[说明](超链接) 这样的语法即可，例如：

![我的空间照片](http://ww4.sinaimg.cn/large/b7ec873bgw1eaigtsdeutj20im0cddjb.jpg) 效果如下：

我的空间照片

四、 引用和代码

在一般的段落文字中，你可以使用反引号来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体， 这项特性让你可以很容易的在代码区段内插入 HTML 码：

这是插入的第一段代码 这是插入的第二行代码 这是插入的第二行代码 这是插入的第二行代码 这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码这是插入的第二行代码

隔开标志

C#代码:

//这里显示一些代码，在正文显示中会自动识别语言，进行代码染色，这是一段C#代码
public class Blog
{
     public int Id { get; set; }
     public string Subject { get; set; }
}

python代码:

for i in range(0,4):
print i,

C++代码:

for（i=0;i<4;i++)
printf i

五、分割线

你可以在一行中用三个或以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。 你也可以在星号中间插入空白。下面每种写法都可以建立分隔线：

1、星号（*）

2、减号（---）

3、底线（---------------）

4、再次星号（**）

六、 区段元素

1、链接 Markdown 支持两种形式的链接语法： 行内和参考两种形式。不管是哪一种，链接的文字都是用 [方括号] 来标记。 要建立一个行内形式的链接，只要在方块括号后面马上接着括号并插入网址链接即可， 如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可. 例如：

this is [我的blog](http://loveliuli.github.io) 效果如下：

this is 我的blog

七、强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成 <strong>，例如：

1、斜线（*）

我是斜线 斜体 ：斜的字体

2、加粗（**）

我是粗体
粗体 ：粗暴的字体

八、程序代码

如果要标记一小段行内程序代码，可以用反引号把它包起来（`），例如：

我们需要打印变量$var1，则如下方式书写：
我们需要`print $var1`

得到的效果如下： 我们需要print $var1

九、链接

1、Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内和参考。

行内式图片的语法如下:

一个惊叹号
接着一个方括号，里面放图片的说明文字
接着一个圆括号，里面放图片的url
![文本](url)
![我的空间照片](http://user.qzone.qq.com/505711559/infocenter)

效果如下： 我的空间照片

连接定义语法：

[foo]: http://example.com/  'Optional Title Here'

例如:

[myblog]: http://loveliuli.github.io/ 'Optional Title Here'

效果如下：

[myblog]: http://loveliuli.github.io/ '我的blog'

参考的语法如下:

This is [an example][id] reference-style link.
[id]: http://example.com/  'Optional Title Here'

十、其他

1、自动链接 <http://loveliuli.github.io>,效果如下： http://loveliuli.github.io

2、转义字符 Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号， 例如：如果想要用星号加在文字旁边的方式来做出强调效果（但不用\ 标签），可以在星号的前面加上反斜杠。 如果我们需要输出星号，则需要转义： 例如：\*我不是斜线\* 效果如下： *我不是斜线*

*我又变成斜线啦* 我又变成斜线啦 3、Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜杠
`   反引号
*   星号
_   底线
{}  大括号
[]  方括号
()  括号
#   井字号
+    加号
-    减号
.   英文句点
!   惊叹号

十一、结束语

以上几种格式是比较常用的格式，所以我们针对这些语法做了比较详细的说明。 除这些之外，Markdown 还有其他语法，如想了解和学习更多，可以参考： 『Markdown 语法说明-官方翻译』。
『Markdown 语法详细说明-图灵社区』。

其他
markdown