这篇文章记录了Markdown语法，其中需要在字符后加空格的均以（有空格）标注。

标题（有空格）

  • 使用 # 表示不同级别的标题（1到6级）
1
2
3
4
5
6
7
8
9
10
11
# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

粗体和斜体

  • 粗体：使用 ** 或 __ 包围文本

  • 斜体：使用 * 或 _ 包围文本

  • 粗体+斜体：使用 *** 或 ___ 包围文本

1
2
3
4
5
6
7
8
**粗体**
__粗体__

*斜体*
_斜体_

***粗体+斜体***
___粗体+斜体___

列表(有空格)

  • 有序列表：使用数字加点（如 1. ）表示
1
2
3
1. 有序列表项
2. 有序列表项
3. 有序列表项
  • 无序列表：使用 -、+ 或 * 来创建
1
2
3
- 无序列表项
* 无序列表项
+ 无序列表项

链接

  • 链接文本可有可无
  • 一般链接
1
[链接文本](https://example.com)
  • 带标题的链接
1
[链接文本](https://example.com "链接标题")

图片

  • 图片描述可有可无
  • 一般图片
1
![图片描述](https://example.com/image.jpg)
  • 带标题的图片
1
![图片描述](https://example.com/image.jpg "图片标题")

引用（有空格）

  • 使用 > 表示引用
1
> 这是一个引用

代码

  • 行内代码：使用单个反引号 ``` 包围代码
1
`行内代码`
  • 代码块：使用三个反引号 ``或缩进4个空格
1
2
3
```
这是代码块
```

分割线

  • 使用三个或更多的 -、* 或 _
1
2
3
---
***
___

表格

  • 使用 | 和 - 创建表格
1
2
3
4
| 标题1 | 标题2 |
|-------|-------|
| 单元格1 | 单元格2 |
| 单元格3 | 单元格4 |

超链接替代文本

  • 使用 [链接名称] 和 [链接名称]: URL 创建带引用的链接
1
2
3
这是 [链接名称][1]

[1]: https://example.com

任务列表(有空格)

  • 在无序列表项前加上 [ ] 表示未完成任务，[x] 表示已完成任务
1
2
- [ ] 未完成任务
- [x] 已完成任务

转义字符

  • 如果想使用特殊字符而不触发其功能，可以使用反斜杠 \ 进行转义
1
\*不会变成斜体*

内联HTML

  • 可以在 Markdown 中使用 HTML 标签来实现更复杂的格式
1
<p>这是一个段落</p>

强制换行

  • 在行尾加两个空格可以创建一个换行
  • 使用 <br> 创建换行
1
2
3
第一行  
第二行<br>
第三行

删除线

  • 使用 ~~ 包围文本来表示删除线
1
~~删除线文本~~

扩展功能(某些解析器不支持)

表情符号

  • 某些 Markdown 解析器支持使用表情符号,使用 ::
1
:smile: :heart: :+1: :sparkles: :dog: :cat:

自动链接

  • 有些 Markdown 解析器可以自动识别 URL，并将其转换为链接
1
https://example.com

脚注

  • 一些 Markdown 解析器支持脚注， 使用 [^]:
1
2
3
[^name]: description

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

表达式（LaTeX 数学公式）

  • 某些 Markdown 扩展支持数学表达式，通常使用 $$ 或 $ 包裹公式
1
2
3
$$
E = mc^2
$$
  • 行内公式
1
爱因斯坦的公式是 $E = mc^2$

定义列表

  • Markdown 的一些扩展支持定义列表，用于创建术语和定义的配对
1
2
3
4
5
Markdown
:  一种轻量级的标记语言

HTML
:  超文本标记语言，用于构建网页

高亮

  • 某些解析器支持文字高亮，通常使用 == 来包围需要高亮的文本
1
这是一个 ==高亮== 示例

下划线

  • 某些 Markdown 解析器支持下划线效果，通常通过 HTML 标签来实现
1
<u>下划线文本</u>

中心对齐

  • 通过 HTML 标签 <center> 来实现文本居中对齐
1
<center>居中的文本</center>
居中的文本

锚点

  • 某些 Markdown 解析器支持为标题或其他元素添加锚点（链接目标）
1
### 标题 {#anchor-id}

然后可以通过 #anchor-id 链接跳转到这个位置

1
[跳转到标题](#anchor-id)

文本对齐

  • 一些 Markdown 解析器支持文本左对齐、右对齐和居中对齐。通常通过使用 HTML 标签来实现
1
2
<p align="center">居中的文本</p>
<p align="right">右对齐的文本</p>

居中的文本

右对齐的文本

HTML 支持

  • Markdown 本身允许内嵌 HTML 标签，以实现更多的排版功能
1
2
3
<strong>加粗</strong>
<em>斜体</em>
<img src="image.png" alt="图片" />

GFM 表格扩展

  • GitHub Flavored Markdown 支持表格的对齐方式，通过在表头和分隔符中添加冒号 : 来控制对齐
1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
|:-------|-------:|:--------:|
| 内容1  | 内容2  | 内容3    |
| 内容4  | 内容5  | 内容6    |
左对齐 右对齐 居中对齐
内容1 内容2 内容3
内容4 内容5 内容6

折叠文本

  • 可以使用 <details> 和 <summary> 标签创建可折叠的文本块
1
2
3
4
<details>
<summary>点击展开</summary>
这是一些隐藏的内容。
</details>
点击展开 这是一些隐藏的内容。

注释

  • Markdown 文件中的注释可以通过 HTML 的注释语法来实现
1
<!-- 这是一个注释，不会在输出中显示 -->

15. 目录生成

  • 某些 Markdown 编辑器或渲染器支持自动生成目录
1
[TOC]

16. 代码行号

  • 某些 Markdown 渲染器可以在代码块中添加行号
1
2
```javascript {numberLines}
// 带有行号的代码块

17. Mermaid图表

  • 可以使用 Mermaid 语法直接在 Markdown 中创建流程图、时序图、甘特图等图表
1
2
3
4
5
6
```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

18. PlantUML

  • 支持通过 PlantUML 生成图表
1
2
3
4
```plantuml
@startuml
Alice -> Bob: Hello
@enduml