Markdown简明语法

在千里码的技能树上了解到Markdown是程序员的必备技能，用了之后发现确实是这样。

我觉得对于我而言以下的语法已经够用了，作为入门是一个不错的选择

目录

在设有标题的段落之前添加

[TOC]

目录

强调

分割线

引用

标题Setext方式

大标题
小标题

标题Atx方式

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

无序列表

嵌套列表

文字超链Inline方式
图片超链

索引超链Reference方式

自动链接

注释

转义字符

代码块

表格

流程图

时序图

标记

强调

星号与下划线都可以，单是斜体，双是粗体，符号可跨行，符号可加空格

**这是星号的强调**
__这是下划线的强调__
*这是跨行
的强调*
_单个是斜体_

这是星号的强调

这是下划线的强调

*这是跨行

的强调*

单个是斜体

分割线

三个或更多-_*，必须单独一行，可含空格

***
---

引用

翻译成html就是

<blockquote></blockquote>

，符号后的空格可不要

> 引用

引用

内层符号前的空格必须要

>引用
>>引用中的引用

引用

引用中的引用

标题：Setext方式

三个或更多

大标题
===
小标题
---

大标题

小标题

标题：Atx方式

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

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

我喜欢用Atx方式，因为Setext方式容易和下划线混淆

无序列表

符号之后的空格不能少，-+*效果一样，但不能混合使用，因混合是嵌套列表，内容可超长

- 无序列表
- 无序列表
- 无序列表
- 无序列表：我很长。我也很长！那比一比啊？比就比！我有这么长，你有我长吗？我有这么这么长！好吧，你赢了！

+ 无序列表+
+ 无序列表+
+ 无序列表+

* 无序列表*
* 无序列表*
* 无序列表*

无序列表

无序列表

无序列表

无序列表：我很长。我也很长！那比一比啊？比就比！我有这么长，你有我长吗？我有这么这么长！好吧，你赢了！

无序列表+

无序列表+

无序列表+

无序列表*

无序列表*

无序列表*

嵌套列表

-+*可循环使用，但符号之后的空格不能少，符号之前的空格也不能少

- 嵌套列表
+ 嵌套列表
+ 嵌套列表
- 嵌套列表
* 嵌套列表
- 嵌套列表

嵌套列表

嵌套列表

嵌套列表

嵌套列表

嵌套列表

嵌套列表

文字超链：Inline方式

在[]之间写入文字超链的名字，也可以叫提示，（）中填入链接就可以了，“”中可以写Tooltips，这个可省略。

[我的孙女叫小芳](http://blog.csdn.net/qq_14998713 "我的孙女叫小芳的博客")

我的孙女叫小芳

图片超链

多个感叹号，Tooltips可省略，要设置大小只能借助HTML标记

![baidu](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/logo_white_fe6da1ec.png "百度")

索引超链：Reference方式

索引，1 2可以是任意字符

[我的博客][1]
[千里码][2]

[1]:http://blog.csdn.net/qq_14998713
[2]:http://www.qlcoder.com/

我的博客

千里码

自动链接

尖括号

<http://blog.csdn.net/qq_14998713>
<http://www.jianshu.com/users/dd6c2bed5bff/latest_articles&g
4000
t;

http://blog.csdn.net/qq_14998713

http://www.jianshu.com/users/dd6c2bed5bff/latest_articles

注释

用html的注释的方式

<!-- 注释 -->

转义字符

用html的注释

Markdown中的转义字符为\，转义的有：

\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号

\ 反斜杠

` 反引号

* 星号

_ 下划线

{} 大括号

[] 中括号

() 小括号

# 井号

+ 加号

- 减号

. 英文句号

! 感叹号

代码块

用两个

```

包围代码块，在第一行后面可以跟语言的类型，也可以不加

@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'''

表格

| Item      |    Value | Qty  |
| :-------- | --------:| :--: |
| Computer  | 1600 USD |  5   |
| Phone     |   12 USD |  12  |
| Pipe      |    1 USD | 234  |

Item	Value	Qty
Computer	1600 USD	5
Phone	12 USD	12
Pipe	1 USD	234

流程图

在代码块里面写，语言类型flow

st=>start: Start

e=>end

op=>operation: My Operation

cond=>condition: Yes or No?

st->op->cond

cond(yes)->e

cond(no)->op

Created with Raphaël 2.1.0StartMy OperationYes or No?Endyesno

时序图

在代码块里写，语言类型sequence

Alice->Bob: Hello Bob, how are you?

Note right of Bob: Bob thinks

Bob–>Alice: I am good thanks!

Created with Raphaël 2.1.0AliceAliceBobBobHello Bob, how are you?Bob thinksI am good thanks!

标记

用两个`号

`标记`

标记

这是我学习使用的一点小的心得，其中借鉴了不少网上的需学习资料