文章

Markdown语法

简介

Markdown 是一种轻量级的标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。

语法

标题

在文字前面加上 # 来创建标题,通过 # 的数量来表示标题的级别。例如:

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

段落和换行

段落之间留一个空行。如果想在段落内强制换行,可以在行尾添加两个或更多的空格然后回车。

强调

可以使用星号(*)或下划线(_)来强调文本。星号或下划线包围的文本会被转换为斜体,如果是两个星号或下划线则转换为粗体。例如:

1
2
3
4
5
*这会是斜体文本*
_这也是斜体文本_

**这会是粗体文本**
__这也是粗体文本__

列表

  • 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记。
  • 有序列表则使用数字后面跟着点号(.)。
1
2
3
4
5
6
7
- 无序列表项一
- 无序列表项二
- 无序列表项三

1. 有序列表项一
2. 有序列表项二
3. 有序列表项三

链接和图片

链接使用方括号来标记文本,后面紧跟着圆括号内的URL。图片则在链接的语法前加上一个感叹号(!)。

1
2
3
[这是一个链接](http://example.com)

![这是一个图片](http://example.com/image.jpg)

这是一个链接

这是一个图片

代码

可以使用反引号(```)来标记代码。对于行内代码,使用单个反引号包围代码。而代码块则用三个反引号包围,并且可以指定语言。

1
`这是行内代码`  ```print("这是一个代码块")```

引用

使用 > 符号来创建引用区块。

1
> 这是一个引用。

分割线

使用三个或更多个星号(*)、减号(-)或下划线(_)来创建分割线。

1
---

表格

Markdown中的表格语法主要由竖线(|)和短横线(-)组成,用来创建行和列。

1
2
3
4
| 列名1 | 列名2 | 列名3 |
|-------|-------|-------|
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

这将会生成如下表格:

列名1 列名2 列名3
单元格1 单元格2 单元格3
单元格4 单元格5 单元格6

表格语法说明:

  • 列名和单元格内容:用竖线(|)分隔每一列的标题和单元格内容。
  • 表头和表体分隔:用短横线(-)和竖线(|)的组合来分隔表头和表体,至少需要三个短横线(---)来表示一个列的分隔

对齐方式:

在表头下方的分隔行中,通过在短横线两侧添加冒号(:),可以指定对应列的对齐方式:

  • 左对齐:在短横线的左侧添加冒号(:)
    1
    2
    3
    
    | 左对齐 | 默认 | 右对齐 |
    |:-------|------|-------:|
    | 文本   | 文本 | 文本   |
    
  • 右对齐:在短横线的右侧添加冒号(:)
  • 居中对齐:在短横线两侧都添加冒号(:)
    1
    2
    3
    
    | 左对齐 | 居中 | 右对齐 |
    |:-------|:----:|-------:|
    | 文本   | 文本 | 文本   |
    

这是一个包含对齐设置的表格示例:

左对齐 居中 右对齐
文本 文本 文本
本文由作者按照 CC BY 4.0 进行授权