Markdown基本语法总结

快捷键

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

分级标题

第一种写法：

    这是一个一级标题
    ============================
    这是一个二级标题
    --------------------------------------------------

第二种写法：

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

注：# 和「一级标题」之间建议保留一个字符的空格，这是最标准的 Markdown 写法。参考图1：

图1

列表

列表格式也很常用，在 Markdown 中，你只需要在文字前面加上 - 就可以了，如果你希望有序列表，也可以在文字前面加上 1. 2. 3. 就可以了，参考图2。

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

图2

插入图片或链接

在 Markdown 中，插入链接不需要其他按钮，语法为：[显示文本](链接地址) 。
在 Markdown 中，插入图片不需要其他按钮，语法为：![](图片链接地址) 。
注：插入图片的语法和链接的语法很像，只是前面多了一个 ！
插入链接和图片的案例，如图3：

图3

引用

在我们写作的时候经常需要引用他人的文字，在 Markdown 中，你只需要在你希望引用的文字前面加上 > 就好了。

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

上面引用的写法，如图4：

图4

再看一个案例的截图，如图5：

图5

粗体和斜体

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

代码引用

需要引用代码时，如果引用的语句只有一段，不分行，可以用 ` 将语句包起来。
如果引用的语句为多行，可以将```置于这段代码的首行和末行。

代码引用的案例截图：

表格

Markdown　Extra　表格语法：

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

显示效果：

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

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

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

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

显示效果：

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

代码块

代码块语法遵循标准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'''

脚注

生成一个脚注^[1]. 语法是：[^footnote]
[^footnote]: 这里是 **脚注** 的 *内容*.这句语法的显示效果一直在页面最后出现。

---

1. 这里是 脚注 的 内容. ↩