CSDN中MarkDown的使用

转载自http://blog.csdn.net/zcf1002797280/article/details/49404329

１. Markdown介绍

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— 维基百科

CSDN提供编辑器支持 Markdown Extra , 　扩展了很多好用的功能。具体代码请参考Github.

---

２. 语法说明

标题

在 Markdown 中，你只需要在文本前面加上#即可，同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题，总共六级，只需要增加#即可，标题字号相应降低。例如：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
1
2
3
4
5
6
1
2
3
4
5
6

链接和图片

在 Markdown 中，插入链接不需要其他按钮，你只需要使用 [显示文本](链接地址)这样的语法即可，例如：

[百度](https://www.baidu.com)
1
1

显示效果：百度

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

![](http://ww4.sinaimg.cn/bmiddle/aa397b7fjw1dzplsgpdw5j.jpg)
1
1

显示效果：

Markdown 支持自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。例如： 
　

引用

在我们写Blog的时候经常需要引用他人的文字，这个时候引用这个格式就很有必要了，在 Markdown 中，只需要在你希望引用的文字前面加上>就好了，例如：

> 矛盾说：我从来不梦想，我只是在努力认识现实；戏剧家洪深说：我的梦想是明年吃苦的能力比今年更强；鲁迅说：人生最大的痛苦是梦醒了无路可走；苏格拉底说：人类的幸福和欢乐在于奋斗，而最有价值的是为了理想而奋斗。
1
1

显示效果：

矛盾说：我从来不梦想，我只是在努力认识现实；戏剧家洪深说：我的梦想是明年吃苦的能力比今年更强；鲁迅说：人生最大的痛苦是梦醒了无路可走；苏格拉底说：人类的幸福和欢乐在于奋斗，而最有价值的是为了理想而奋斗。

粗体和斜体

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

大概是任何一件不起眼的小事被某个人有意识地重复了*几十年*，*甚至一生*，而形成的某个**传说**。
1
1

大概是任何一件不起眼的小事被某个人有意识地重复了几十年，甚至一生，而形成的某个传说。

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，可以在星号或是减号中间插入空格，例如：

***
* * * 
*******
---
_____   
1
2
3
4
5
1
2
3
4
5

中文首行缩进

两种方法可以实现：

• 把输入法由半角改为全角。 两次空格之后就能够有两个汉字的缩进。
• 在段落开头的时候，先输入：       ，然后紧跟着输入文本即可。

表格

表格代码：

项目     | 价格
-------- | ---
Computer | $1600
Phone    | $12
Pipe     | $1
1
2
3
4
5
1
2
3
4
5

显示效果：

项目	价格
Computer	$1600
Phone	$12
Pipe	$1

可以使用冒号来定义对齐方式：

表格代码：

| 项目      |    价格 | 数量  |
| :-------- | --------:| :--: |
| Computer  | 1600 元 |  5   |
| Phone     |   12 元 |  12  |
| Pipe      |    1 元 | 234  |
1
2
3
4
5
1
2
3
4
5

显示效果：

项目	价格	数量
Computer	1600 元	5
Phone	12 元	12
Pipe	1 元	234

定义列表

无序列表：只需要在文字前面加上- 、*、+就可以了，它们效果是一样的，例如：

+ 语文
+ 数学
+ 英语
1
2
3
1
2
3

显示效果：

• 语文
• 数学
• 英语

有序列表：用数字加英文的句点，这里数字不会影响输出，比如：

1. 机器学习
5. 模式识别
3. 人工智能
1
2
3
1
2
3

显示效果：

1. 机器学习
2. 模式识别
3. 人工智能

缩进列表：用:标记要缩进的行，例如：

项目１
: 定义 A
: 定义 B

项目２
: 定义 C
: 定义 D
1
2
3
4
5
6
7
1
2
3
4
5
6
7

显示效果：

项目１

定义 A

定义 B

项目２

定义 C

定义 D

代码

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

C语言中使用`printf()`进行格式化输出。
1
1

显示效果：　C语言中使用printf()进行格式化输出。

代码块

将要显示的代码块放在３对反引号中间，CSDN提供的编译器支持不同的语法高亮，只要在反引号后接上语言，例如：

 ``` python
 @requires_authorization
 def somefunc(param1='', param2=0):
     '''A docstring'''
     if param1 > param2: # interesting
         print 'Greater'
     return (param2 - param1 + 1) or None
 class SomeClass:
     pass
 >>> message = '''interpreter
 ... prompt'''
 ```
1
2
3
4
5
6
7
8
9
10
11
12
1
2
3
4
5
6
7
8
9
10
11
12

显示效果：

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''
1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10

脚注

markdown 代码：

生成一个脚注[^footnote].
  [^footnote]: 这里是 **脚注** 的 *内容*.

注：footnote是自定义变量  
1
2
3
4
1
2
3
4

显示效果： 
生成一个脚注1.

目录

用 [TOC]来生成目录，现在默认会生成目录。

UML 图

可以渲染序列图，例如：

```sequence
张三->李四: 嘿，小四儿, 写博客了没?
Note right of 李四: 李四愣了一下，说：
李四-->张三: 忙得吐血，哪有时间写。
 ```
1
2
3
4
5
1
2
3
4
5

显示效果：

张三张三李四李四嘿，小四儿, 写博客了没?李四愣了一下，说：忙得吐血，哪有时间写。

流程图markdown代码如下：

```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？

st->op->cond
cond(yes)->e
cond(no)->op
 ```
1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10

显示效果：

开始我的操作确认？结束yesno

• 关于 序列图 语法，参考 这儿,
• 关于 流程图 语法，参考 这儿.

３. 离线写博客

即使在没有网络的情况下，也可以通过本编辑器离线写博客（直接在曾经使用过的浏览器中输入write.blog.csdn.net/mdeditor即可。Markdown编辑器使用浏览器离线存储将内容保存在本地。

在写博客的过程中，内容会实时保存在浏览器缓存中，在关闭浏览器或者其它异常情况下，内容都不会丢失。再次打开浏览器时，会显示上次正在编辑的没有发表的内容。

博客发表后，本地缓存将被删除。　

可以选择 把正在写的博客保存到服务器草稿箱，即使换浏览器或者清除缓存，内容也不会丢失。

---

４. 浏览器兼容

1. 目前，CSDN提供的编辑器对Chrome浏览器支持最为完整。建议大家使用较新版本的Chrome。
2. IE９以下不支持
3. IE９，１０，１１存在以下问题 
   
   1. 不支持离线功能
   2. IE9不支持文件导入导出
   3. IE10不支持拖拽文件导入

---

５. 快捷键

• 加粗 Ctrl + B
• 斜体 Ctrl + I
• 引用 Ctrl + Q
• 插入链接 Ctrl + L
• 插入代码 Ctrl + K
• 插入图片 Ctrl + G
• 提升标题 Ctrl + H
• 有序列表 Ctrl + O
• 无序列表 Ctrl + U
• 横线 Ctrl + R
• 撤销 Ctrl + Z
• 重做 Ctrl + Y

---

６. 总结

CSDN提供的Markdown编辑器使用StackEdit修改而来，它有如下特点：

• Markdown和扩展Markdown简洁的语法
• 代码块高亮
• 图片链接和图片上传
• LaTex数学公式
• UML序列图和流程图
• 离线写博客
• 导入导出Markdown文件
• 丰富的快捷键