Markdown新手指南

发表于 更新于

标题

这是最为常用的格式，只需要在文本前面加上 # 即可，同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题，总共六级，只需要增加 # 即可，标题字号相应降低。例如：

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

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

效果如下：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

列表格式也很常用，只需要在文字前面加上 - 就可以了，例如：

1
2
3
- 文本1
- 文本2
- 文本3

如果你希望有序列表，
也可以在文字前面加上 1. 2. 3. 就可以了，例如：

1
2
3
1. 文本1
2. 文本2
3. 文本3

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

效果如下：

  • 文本1
  • 文本2
  • 文本3
  1. 文本1
  2. 文本2
  3. 文本3

链接和图片

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

1
[菜鸟教程](https://www.runoob.com/)

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

1
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)

注：插入图片的语法和链接的语法很像，只是前面多了一个！。

效果如下：

菜鸟教程
RUNOOB 图标

引用

当需要引用他人的文字时，在Markdown中，你只需要在你希望引用的文字前面加上 > 就好了，例如：

1
2
> 我有明珠一颗，久被尘劳关锁。
而今尘尽光生，照破青山万朵。

注：> 和文本之间要保留一个字符的空格。

效果如下：

我有明珠一颗，久被尘劳关锁。
而今尘尽光生，照破青山万朵。

粗体和斜体

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

1
2
*我有明珠一颗*，**久被尘劳关锁**。
而今尘尽光生，照破青山万朵。

效果如下：
我有明珠一颗，久被尘劳关锁。
而今尘尽光生，照破青山万朵。

代码引用

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

1
`print('Hello world!')`
1
2
3
4
5
6
7
``` 
def my_abs(x):
    if x >= 0:
        return x
    else:
        return -x
```

效果如下：
print('Hello world!')

1
2
3
4
5
def my_abs(x):
    if x >= 0:
        return x
    else:
        return -x

表格

参考代码：

1
2
3
4
5
| Name          | Age           | Sex   |
| ------------- |-------------- | ----- |
| Zhangsan      | 10            |   male|
| Lisi          | 20            |   male|
| Wangwu        | 30            | female|

效果如下：

Name Age Sex
Zhangsan 10 male
Lisi 20 male
Wangwu 30 female

我们可以设置表格的对齐方式：

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。
    例如：
    1
    2
    3
    4
    | 左对齐 | 右对齐 | 居中对齐 |
    | :-----| ----: | :----: |
    | 11111 | 11111 | 11111  |
    | 11    | 11    | 11     |
    效果如下：
左对齐 右对齐 居中对齐
11111 11111 11111
11 11 11

结语

以上几种格式是比较常用的格式，如想了解和学习更多，可以参考菜鸟教程上的Markdown教程