Markdown基本语法

最近无意中发现了一款轻量级的标记语言，语法简单，排版方便，正好最近想学习大数据与机器学习相关的知识，并计划时常写一些博客来做笔记，感觉Markdown应该是比较适合编辑，所以把博客园的编辑器改成了markdown,并在以后的记录中习惯使用。下面就总结一些Markdown的基本语法方便随时查阅。

1.段落和换行

段落中如果要强制换行，可以输入两个空格键加一个回车键实现。

2.标题

标题设置有两种方式
第一种，标题前加 # 号表示，总共分为六级标题，建议在 # 号后加一个空格，这是最标准的Markdown语法。

# 标题一
## 标题二
### 标题三
#### 标题四
##### 标题五
###### 标题六    

一级到六级演示效果分别如下：

标题一

标题二

标题三

标题四

标题五

标题六

第二种，通过在文字下方添加 = 或 -，他们分别表示一级标题和二级标题。（任何数量的 = 或 - 效果相同）。

标题一
======
标题二
------

效果分别如下：

标题一

标题二

3.区块引用

如果需要引用一小段别处的句子，那么就要用引用的格式。

例如这样

只需在文本前加入 > 这种尖括号（大于号）即可。
区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ：

> 应用1
> > 嵌套引用
> 
> 引用2	

效果如下：

引用1

嵌套引用

引用2

4.粗体与斜体

Markdown的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体和语法，用一个 * 包含一段文本就是斜体的语法。

**这里是粗体** *这里是斜体*

效果为：这里是粗体 这里是斜体

5.列表

Markdown支持有序列表和无序列表。
无序列表只需在文字前加上星号、加号或是减号即可。

* Red
* Green
* Blue

等价于：

+ Red
+ Green
+ Blue

也等价于:

- Red
- Green
- Blue

效果如下：

• Red

• Green

• Blue

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

1. Red
2. Green
3. Blue

效果如下：

1. Red
2. Green
3. Blue

6.代码区块

代码区块中的内容不会进行排版，而是按照原来的样子显示。在Markdown中代码区只要简单的缩进4个空格或者1个制表符就可以。

这是一个普通段落：
	
	这是一个代码区块。

7.分割线

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

* * *
***
*****
- - -
——————————————————————————————————————————

会产生两种效果的分割线，如下显示：

---

---

——————————————————————————————————————————

8.链接

Markdown中有两种方式实现链接，分别为内联方式和引用方式。不管是哪一种，链接文字都是用 [方括号] 来标记。

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

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

效果如下：
This is an example inline link.
This link has no title attribute.

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

See my [About](/about/) page for details.

引用方式链接，使用另外一个方括号接在链接文字的括号后面，而在第二个方括号里面要填入用以辨识链接的标签：

This is [an example][id] reference-style link.

也可以选择性地在两个方括号中间加上空白：

This is [an example] [id] reference-style link.

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

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

链接定义的形式为：

• 方括号，里面输入链接的辨识用标签
• 接着一个冒号
• 接着一个以上的空白或 tab
• 接着链接的网址
• 选择性地接着 title 内容，可以用单引号、双引号或是括号包着

下面这三种链接的定义都是相同：

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

网址定义只有在产生链接的时候用到，并不会直接出现在文档之中。
示例：

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
[1]: http://google.com/        "Google" 
[2]: http://search.yahoo.com/  "Yahoo Search" 
[3]: http://search.msn.com/    "MSN Search"

效果如下：
I get 10 times more traffic from Google than from Yahoo or MSN.

9.程序代码

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

Use the `printf()` function.

效果为： Use the printf() function.
如果要在程序代码区段内插入反引号，可以用多个反引号来开启和结束程序代码区段：

``There is a literal backtick (`) here.``
`` There is a literal backtick (`) here. ``

效果为：There is a literal backtick (`) here.

10.图片

Markdown图片的语法和链接很相似，也分别为内联方式和引用方式。
内联方式图片的语法看起来像是：

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替换文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

引用方式图片语法类似这样：

![Alt text][id]

「id」是图片参考的名称，图片参考的定义方式则和链接参考一样：

[id]: url/to/image  "Optional title attribute"

11.自动链接

Markdown 支持比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接，链接的文字就和链接位置一样，例如：

<http://example.com/>

效果为: http://example.com/

12.转义字符

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），可以在星号的前面加上反斜杠：

\*literal asterisks\*

Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号：

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

---

编辑器

本人使用的是Window系统，所以选择了MarkdownPad。

参考文献

http://daringfireball.net/projects/markdown/basics
http://www.cnblogs.com/hnrainll/p/3514637.html
http://www.ituring.com.cn/article/504
http://www.jianshu.com/p/1e402922ee32/

建议

建议初次接触Markdown语法的同学，可以像我这样在学习的过程中尝试写一个符合自己查阅习惯的总结，在总结完成以后，也就熟悉了Markdown语法的使用。本篇博客是用Markdown所写，文章最后会给出源文件下载地址，希望想学习的同学可以作为一个参考。

附件下载