垦荒学园

简体中文

English

简体中文

English

切换主题

Markdown 基本语法 ​

Markdown 的基本语法简单易学，本章将介绍最常用的核心语法，让你快速掌握 Markdown 的基础用法。

段落和换行 ​

段落 ​

段落之间用空行分隔：

markdown
这是第一段。

这是第二段。

效果：

这是第一段。

这是第二段。

换行 ​

在行尾添加两个空格或使用 <br> 标签：

markdown
第一行  
第二行

效果：

第一行
第二行

标题 ​

使用 # 号创建标题，支持 1-6 级标题：

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

效果：

一级标题 ​

二级标题 ​

三级标题 ​

四级标题 ​

五级标题 ​
六级标题 ​

文本样式 ​

粗体 ​

使用 ** 或 __ 包围文本：

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

效果： 这是粗体文本

斜体 ​

使用 * 或 _ 包围文本：

markdown
*这是斜体文本*
_这也是斜体文本_

效果： 这是斜体文本

粗斜体 ​

使用 *** 或 ___ 包围文本：

markdown
***这是粗斜体文本***
___这也是粗斜体文本___

效果： 这是粗斜体文本

删除线 ​

使用 ~~ 包围文本：

markdown
~~这是删除线文本~~

效果： 这是删除线文本

列表 ​

无序列表 ​

使用 -、+ 或 * 创建：

markdown
- 项目一
- 项目二
- 项目三

效果：

  • 项目一
  • 项目二
  • 项目三

有序列表 ​

使用数字加 . 创建：

markdown
1. 第一项
2. 第二项
3. 第三项

效果：

  1. 第一项
  2. 第二项
  3. 第三项

嵌套列表 ​

使用缩进创建嵌套：

markdown
- 主项目
  - 子项目 1
  - 子项目 2
    - 子子项目

效果：

  • 主项目
    • 子项目 1
    • 子项目 2
      • 子子项目

链接 ​

行内链接 ​

markdown
[链接文本](https://example.com)
[带标题的链接](https://example.com "鼠标悬停显示的标题")

效果： 链接文本

引用链接 ​

markdown
[链接文本][ref]

[ref]: https://example.com "可选标题"

自动链接 ​

markdown
<https://example.com>
<email@example.com>

效果： https://example.com

图片 ​

基本语法 ​

markdown
![替代文本](图片URL)
![带标题的图片](图片URL "图片标题")

引用式图片 ​

markdown
![替代文本][img-ref]

[img-ref]: 图片URL "可选标题"

引用 ​

使用 > 创建引用块：

markdown
> 这是一段引用文本。
> 可以有多行。

效果：

这是一段引用文本。 可以有多行。

嵌套引用 ​

markdown
> 第一层引用
>> 第二层引用
>>> 第三层引用

效果：

第一层引用

第二层引用

第三层引用

代码 ​

行内代码 ​

使用反引号 ` 包围：

markdown
这是 `行内代码` 示例。

效果： 这是 行内代码 示例。

代码块 ​

使用三个反引号 ``` 创建：

markdown
```
这是代码块
可以有多行
```

带语法高亮的代码块 ​

markdown
```python
def hello():
    print("Hello, World!")
```

效果：

python
def hello():
    print("Hello, World!")

分割线 ​

使用三个或更多的 -、* 或 _：

markdown
---
***
___

效果：

表格 ​

使用 | 和 - 创建表格：

markdown
| 列1 | 列2 | 列3 |
|------|------|------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

效果：

列1列2列3
内容1内容2内容3
内容4内容5内容6

对齐方式 ​

markdown
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 左 | 中 | 右 |

效果：

左对齐居中对齐右对齐
左中右

转义字符 ​

使用反斜杠 \ 转义特殊字符：

markdown
\* 这不是斜体 \*
\# 这不是标题

效果： * 这不是斜体 *

需要转义的字符 ​

\   反斜杠
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  圆括号
#   井号
+   加号
-   减号
.   英文句点
!   感叹号

任务列表 ​

使用 - [ ] 和 - [x] 创建：

markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个任务

效果：

  • [x] 已完成任务
  • [ ] 未完成任务
  • [ ] 另一个任务

脚注 ​

markdown
这是一段文本[^1]。

[^1]: 这是脚注内容。

HTML 标签 ​

Markdown 支持内嵌 HTML：

markdown
<div style="color: red;">
这是红色文本
</div>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

效果：

Ctrl + C

常用 HTML 标签 ​

文本颜色 ​

html
<span style="color: red;">红色文本</span>
<span style="color: blue;">蓝色文本</span>

文本对齐 ​

html
<center>居中文本</center>
<div align="right">右对齐文本</div>

上标和下标 ​

html
H<sub>2</sub>O
X<sup>2</sup>

效果： H2O, X2

注释 ​

Markdown 中的注释不会显示：

markdown
<!-- 这是注释，不会显示在页面上 -->

快速参考表 ​

元素语法
标题# H1 ## H2 ### H3
粗体**粗体**
斜体*斜体*
引用> 引用
有序列表1. 项目
无序列表- 项目
代码`代码`
分割线---
链接[文本](URL)
图片![alt](URL)

实践练习 ​

尝试创建一个包含以下元素的文档：

  1. 一个一级标题
  2. 一段介绍文字（包含粗体和斜体）
  3. 一个无序列表
  4. 一个有序列表
  5. 一段引用
  6. 一个代码块
  7. 一个链接
  8. 一个表格

小结 ​

本章介绍了 Markdown 的基本语法，包括：

  • 标题和段落
  • 文本格式（粗体、斜体、删除线）
  • 列表（有序、无序、嵌套）
  • 链接和图片
  • 引用和代码
  • 表格和分割线

掌握这些基本语法后，你就可以开始使用 Markdown 进行日常写作了。接下来，我们将深入学习每个语法的详细用法。

下一步： 学习 Markdown 标题 的详细用法。