Markdown简明语法

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

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

目录

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

[TOC]

强调

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

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

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

---

分割线

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

***
---

---

---

引用

翻译成html就是<blockquote></blockquote>，符号后的空格可不要
> 引用

引用

内层符号前的空格必须要

>引用
 >>引用中的引用

引用

引用中的引用

---

标题：Setext方式

三个或更多

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

大标题

小标题

---

标题：Atx方式

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

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

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

---

无序列表

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

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

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

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

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

---

嵌套列表

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

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

• 嵌套列表
  
  • 嵌套列表
  • 嵌套列表
  • 嵌套列表
  • 嵌套列表
• 嵌套列表

---

文字超链：Inline方式

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

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

我的孙女叫小芳

---

图片超链

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

![baidu](https://i-blog.csdnimg.cn/blog_migrate/24dd60428e4a8af2a2da3d87a226ab9b.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>

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

---

时序图

在代码块里写，语言类型sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob–>Alice: I am good thanks!

---

标记

用两个`号

`标记`

标记

---

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