# Markdown新手指南

# 标题

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

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

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

效果如下:

# 一级标题

# 二级标题

# 三级标题

# 四级标题

# 五级标题
# 六级标题

# 列表

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

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

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

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

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

效果如下:

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

# 链接和图片

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

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

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

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

注:插入图片的语法和链接的语法很像,只是前面多了一个!。

效果如下:

# 菜鸟教程 RUNOOB 图标

# 引用

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

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

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

效果如下:

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


# 粗体和斜体

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

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

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

# 代码引用

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

`print('Hello world!')`
``` 
def my_abs(x):
    if x >= 0:
        return x
    else:
        return -x
```

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

def my_abs(x):
    if x >= 0:
        return x
    else:
        return -x

# 表格

参考代码:

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

效果如下:

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

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

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。 例如:
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 11111 | 11111 | 11111  |
| 11    | 11    | 11     |

效果如下:

左对齐 右对齐 居中对齐
11111 11111 11111
11 11 11

# 结语

以上几种格式是比较常用的格式,如想了解和学习更多,可以参考菜鸟教程上的Markdown教程 另外,推荐一个免费的Markdown工具Typora,支持Mac OS、Windows和Linux,官网地址:https://www.typora.io/


本文由Openwit 创作,采用知识共享署名4.0国际许可协议进行许可。 本站文章除注明转载外,均为本站原创或翻译,转载请注明出处。 最后更新于: 2020-03-18