### Markdown 常用语法详解
#### 一、Markdown 使用方法概述
Markdown 是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，再转换成结构化的HTML（标准通用标记语言的一个应用）文档。Markdown 的设计理念是使“易于阅读”的文本可以直接作为最终展示文本，同时也易于转换成结构化的HTML文档。本文档基于个人学习经验，汇总了Markdown的基础语法，旨在帮助初学者快速掌握Markdown的基本用法。
#### 二、文本格式介绍
##### 2.1 标题格式
Markdown 支持两种类型的标题格式：
- **底线模式**：适用于创建一级或二级标题，通过在标题文字下方添加两个或更多的`=`或`-`字符来实现。例如：
```
# 一级标题
===============
## 二级标题
-----------------
```
- **哈希模式**：支持创建一到六级标题，通过在行首放置相应数量的`#`符号后加一个空格来实现。例如：
```
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```
##### 2.2 段落格式
Markdown 中的段落由一行或多行文本组成，这些文本行之间没有空白行。为了创建一个新的段落，只需在两段文本之间插入一个空白行即可。
- **空格**：Markdown 中，空格的显示效果与普通文本相同，但不建议使用多个连续空格，除非有特殊需求。若需使用多个空格，可以使用HTML实体`\ `。
- **换行**：若要在同一段落内换行，可以在行尾添加两个空格后再按回车键。例如：
```
这是第一行。
这是第二行。
```
- **连续换行多行**：不推荐使用连续换行来分割内容，应使用段落或列表等元素。若必须换行，可以使用HTML的`<br>`标签。
##### 2.3 字体、图片与超链接
Markdown 提供了丰富的工具来改变文本样式，插入图片和链接。
###### 2.3.1 修改字体
- **加粗**：使用双星号`**`或双下划线`__`包围文本以实现加粗效果。例如：
```
**加粗文本** 或 __加粗文本__
```
- **斜体**：使用单星号`*`或单下划线`_`包围文本以实现斜体效果。例如：
```
*斜体文本* 或 _斜体文本_
```
- **加粗斜体**：使用三重星号`***`或组合双下划线与单下划线`**_`包围文本以实现加粗斜体效果。例如：
```
***加粗斜体文本*** 或 **_加粗斜体文本_**
```
- **删除线**：使用双波浪线`~~`包围文本以实现删除线效果。例如：
```
~~删除线文本~~
```
- **高亮**：使用双等号`==`包围文本以实现高亮效果。例如：
```
==高亮文本==
```
- **转义字符**：使用反斜杠`\`来转义特殊字符。例如：
```
\* 星号
\_ 下划线
\` 反引号
```
###### 2.3.2 插入图片
Markdown 中插入图片非常简单，只需要在普通链接前加上感叹号`!`。图片可以使用相对路径或绝对路径。
- **基本写法**：使用``。例如：
```
```
- **高级写法**：对于更复杂的需求，如设置图片宽度等，建议使用HTML/CSS实现。
##### 2.4 列表与区块
Markdown 支持创建有序和无序列表，并提供区块引用和代码块功能。
###### 2.4.1 无序列表
无序列表由星号`*`、加号`+`或减号`-`引导每一项。例如：
```
* 项目1
* 项目2
* 项目3
```
可以嵌套子列表：
```
* 项目1
* 子项目1
* 子项目2
* 项目2
```
###### 2.4.2 有序列表
有序列表由数字后跟一个点`.`引导每一项。例如：
```
1. 项目1
2. 项目2
3. 项目3
```
同样可以嵌套子列表：
```
1. 项目1
1. 子项目1
2. 子项目2
2. 项目2
```
###### 2.4.3 区块
区块引用用于突出显示文档中的某些部分，通常用于引用其他来源的内容。其基本语法是使用大于号`>`引导每行。例如：
```
> 这是一段引用的文字。
```
可以嵌套区块引用：
```
> 主引用
>> 子引用
```
###### 2.4.4 代码块
代码块有两种方式：内联代码块和独立代码块。
- **内联代码块**：使用反引号`\``包围代码片段。例如：
```
`print("Hello, world!")`
```
- **独立代码块**：使用三个反引号包围代码，可选指定编程语言以实现高亮。例如：
```
```python
print("Hello, world!")
```
```
#### 三、作图
Markdown 直接支持的绘图能力有限，但可以通过以下几种方式进行图表制作：
##### 3.1 绘制表格
Markdown 支持简单的表格语法，但功能较为有限。表格的基本语法如下：
```
| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
```
##### 3.2 PlantUML 作图
PlantUML 是一种用于创建UML图和其他类型图表的语言，可以在Markdown中使用。虽然Markdown本身不直接支持PlantUML语法，但可以通过集成第三方工具来实现。
#### 四、设计说明
Markdown 的设计哲学强调简洁性和易读性，它旨在简化文档编写过程，使得作者能够专注于内容本身而非格式细节。因此，在使用Markdown编写文档时，应遵循以下原则：
- **清晰简洁**：尽量使用简洁明了的语言和格式。
- **一致性**：在整个文档中保持一致的格式风格。
- **语义性**：合理利用Markdown提供的各种语法元素，使文档结构更加语义化。
#### 五、其他
除了上述基础语法外，Markdown 还支持其他一些特性，例如自动生成目录、脚注、任务列表等。这些特性可能依赖特定的Markdown处理器，如Pandoc、GitHub Flavored Markdown (GFM)等。
- **自动生成目录**：某些Markdown处理器支持通过特定语法自动生成目录。
- **脚注**：Markdown 支持脚注，可以在文档中添加额外的信息或引用。
- **任务列表**：在某些环境中，如GitHub，Markdown支持创建任务列表，方便跟踪任务完成情况。
通过以上介绍，读者应该已经对Markdown的基本语法有了初步了解。Markdown 的强大之处在于它的简单性与灵活性，使得用户能够轻松地编写出结构清晰、格式美观的文档。希望读者能够在日常写作中充分利用Markdown的强大功能，提高工作效率。
