Openwit

Markdown 新手指南

· openwit

标题

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

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

注:# 和「标题」之间建议保留一个字符的空格,这是最标准的 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 图标](https://static.jyshare.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教程