Markdown语法基础教程

Markdown基础语法教程

介绍

Markdown是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与HTML混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。
接下来我将为你讲授基础语法，学习了这些后就足够日常使用。
让我们从标题语法开始学习吧！

标题

要创建标题，请在内容前添加井号(#)。井号的数量代表了标题的级别，例如，添加4个#代表添加了一个HTML标签<h4>。
例如：

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

注意
标题和#符号之间要有一个空格

效果如下：
效果1

你也可以使用在内容下添加=或-来表示一级标题和二级标题
例如：

1
2
Heading lv1
===========

效果：
效果2

1
2
Heading lv2
-----------

效果3

字体

Markdown有两种字体，分别是 粗体 和 斜体
只有一个 * 包裹的是斜体，由两个 * 包裹的是粗体，由三个 * 包裹的是粗斜体。(将 * 替换为 _ 也可以，效果是一样的，不过建议使用*。)
例如:

1
2
3
*This is a simple text*
**This is a simple text**
***This is a simple text***

效果如下：
效果4

段落

创建一个段落，只需要在两个段落之间添加一个空白行即可

注意 不要使用空格和制表符（tab）缩进段落

例如：

1
2
3
This is first paragraph.

This is second paragraph.

效果：
效果5

换行

Markdown有多种换行方式

  1. 在需要换行的地方添加两个空格
  2. 两句话之间添加一个空白行
  3. 在两句话之间添加<br/>标签

引用

可以在前面添加 > 符号进行引用
例如：

1
> 这是一个引用

效果如下：

这是一个引用

如果要引用多个段落，需要在空白行前也添加 > 符号。
例如：

1
2
3
> This is first paragraph.
>
> This is second paragraph.

效果如下：

This is first paragraph.

This is second paragraph.

同样的，引用可以嵌套在引用中，使用 >> 来表示被嵌套在引用内。
例如：

1
2
3
> 第一段
> 第二段
>> 第二段第一节

效果如下：

第一段
第二段

第二段第一节

引用内部也可以添加其他的Markdown格式的元素，但并非所有元素都可以使用，你可以自行尝试哪些可以用。
例如：

1
2
3
> ### 标题1
> 
> 1. 表格1

效果如下：

标题1

  1. 表格1

链接

在文章内部也是可以插入链接的，具体格式如下：

1
2
3
4
[链接显示名称](链接地址)

例如：
[这是我的主页](#)

效果如下：
这是我的主页

图片

文章内同样可以插入图片，用法与链接差不多，格式如下：

1
2
3
4
5
6
7
![图片alt](图片地址src "图片title")

比如：
![示例](https://img.ttest.fun/i/2025/06/23/c39mcw.jpg "示例图片")

如果要为图片添加链接，格式为：
[![图片alt](图片地址src "图片title")](图片链接)

效果如下：
示例

列表

列表分为有序列表和无序列表两种

有序列表

有序列表使用 数字+.+空格 进行表示。

1
2
3
1. 列表1
2. 列表2
3. 列表3

效果如下：

  1. 列表1
  2. 列表2
  3. 列表3

无序列表

无序列表使用 *或+或- 再加上一个空格来表示。

1
2
3
- 列表1
+ 列表2
* 列表3

效果如下；

  • 列表1
  • 列表2
  • 列表3

列表的嵌套

列表同样可以进行嵌套，只需要使用制表符(tab)即可。

1
2
3
4
5
6
1. 列表1
2. 列表2
    1. 列表3
- 列表1
- 列表2
    - 列表3

效果如下：

  1. 列表1
  2. 列表2
    1. 列表3
  • 列表1
  • 列表2
    • 列表3

代码块

Markdown中的代码块可以分为两种，一种是单行内的代码，另一种是多行组成的代码块。

单行

如果在单行内的代码，只需要使用反引号`包裹即可。
例如：

1
`Hello` World!

效果如下：
Hello World!

多行

对于多行的代码块，需要使用三个反引号`进行包裹(三个反引号独占一行)，并且可以在第一行反引号后添加使用的语言。
例如写一个简单的python代码：
py
效果如下：

1
print("Hello World!")

分割线

Markdown中可以使用三个 * 或者 - 来表达分割线

需要注意的是，一定要在分割线前空一行！

例如：

1
2
3
4
5
6
7
内容1

---
***
- - -
* * *
内容2

效果如下：
内容1

内容2

删除线

使用 ~~ 包裹需要删除的内容即可。
例如：

1
~~删除线删除线~~

效果如下：
删除线删除线

表格

在Markdown中，你可以很快速的制作一个表格。

使用 | 来分割单元格，- 来分割表头与其他行。

  • :- 表示左对齐
  • -: 表示右对齐
  • :-: 表示居中对齐

例如：

1
2
3
4
| 姓名 | 薪水 | 职位 |
| :--: | :-- | ---:|
| John | 16000 | CEO |
| Mary | 251000 | VP |

效果如下：

姓名 薪水 职位
John 16000 CEO
Mary 251000 VP

更多高级用法

Markdown 还有更多高级用法，例如使用 - [] 和 - [x] 来制作待办清单等，以后可能会写一篇进阶教程。

掌握了本篇文章的知识点后，已经足够日常使用。

想要了解更多用法，可以去这里进行深入学习。