Markdown语法速查表：从初学者到高级

简介

Markdown是一种轻量级标记语言，让您可以使用易读易写的纯文本格式编写文档。本速查表涵盖了从基础到高级的所有Markdown语法，并提供了实用示例。无论您是Markdown新手还是想要查阅特定语法，这份指南都能为您提供帮助。

基础语法

标题（Headings）

Markdown支持六级标题，使用#符号表示：

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

也可以使用下划线形式（仅支持一级和二级）：

一级标题
========

二级标题
--------

段落和换行

段落之间需要空行分隔。如果需要换行而不开始新段落，在行尾添加两个空格。

这是第一段。

这是第二段。

这是一行  
这是下一行（注意上一行末尾的两个空格）

文本格式

效果	语法	示例
粗体	`文本` 或 `__文本__`	粗体文本
斜体	`文本` 或 `_文本_`	斜体文本
粗斜体	`*文本*` 或 `___文本___`	*粗斜体文本*
删除线	`~~文本~~`	~~删除线文本~~
下划线	`<u>文本</u>`	下划线文本

列表

无序列表

使用-、+或*创建无序列表：

- 项目一
- 项目二
  - 子项目 2.1
  - 子项目 2.2
- 项目三

+ 也可以使用加号
* 或者星号

有序列表

使用数字加点创建有序列表：

1. 第一项
2. 第二项
   1. 子项目 2.1
   2. 子项目 2.2
3. 第三项

任务列表

GitHub风格的任务列表：

- [x] 已完成任务
- [ ] 待办任务
- [ ] 另一个待办任务

链接

行内链接

[链接文本](https://www.example.com)
[带标题的链接](https://www.example.com "链接标题")

参考链接

[链接文本][参考标识]

[参考标识]: https://www.example.com "可选标题"

自动链接

<https://www.example.com>
<[email protected]>

图片

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

参考式图片：
![替代文本][图片参考]

[图片参考]: 图片URL "可选标题"

引用

> 这是一段引用
> 可以有多行
> 
> > 还可以嵌套引用

代码

行内代码

使用`反引号`包围行内代码

代码块

使用三个反引号或缩进四个空格：

```javascript
function hello() {
    console.log("Hello, World!");
}
```

    或者使用缩进（四个空格）
    function hello() {
        console.log("Hello, World!");
    }

分隔线

使用三个或更多的连字符、星号或下划线：

---
***
___

高级语法

表格

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

对齐方式：
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 左 | 中 | 右 |

脚注

这是一个脚注示例[^1]。

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

定义列表

术语1
: 定义1

术语2
: 定义2a
: 定义2b

缩写

HTML是超文本标记语言。

*[HTML]: Hyper Text Markup Language

GitHub风格Markdown（GFM）

语法高亮

在代码块中指定语言：

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

```json
{
  "name": "example",
  "version": "1.1.0"
}
```

表情符号

:smile: :heart: :thumbsup: :star:

用户提及和问题引用

@用户名
#123 (问题编号)
组织/仓库#123

HTML支持

Markdown支持内嵌HTML：

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

<details>
  <summary>点击展开</summary>
  隐藏的内容
</details>

转义字符

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

\* 不是斜体
\# 不是标题
\[不是链接\]

需要转义的字符：

\ ` * _ {} [] () # + - . ! |

最佳实践

1. 保持一致性

选择一种标题风格并坚持使用
统一使用*或-作为列表标记
保持缩进一致（通常使用2或4个空格）

2. 可读性优先

在标题前后添加空行
段落之间使用空行分隔
避免过长的行（建议80-100字符）

3. 语义化使用

按层级使用标题，不要跳级
使用合适的标记（如列表、引用等）
为链接和图片提供描述性文本

常见错误

1. 列表格式错误

错误：
-项目一（缺少空格）
- 项目二

正确：
- 项目一
- 项目二

2. 链接格式错误

错误：
(链接文本)[URL]

正确：
[链接文本](URL)

3. 代码块缩进

错误：
```
代码
```

正确：
```
代码
```

工具技巧

使用MD-PDF-WORD

MD-PDF-WORD完美支持所有这些Markdown语法，并能准确地转换为PDF和Word格式：

保留所有格式
正确渲染表格
支持代码高亮
处理中文排版

快捷键（常见编辑器）

功能	Windows/Linux	Mac
粗体	Ctrl + B	Cmd + B
斜体	Ctrl + I	Cmd + I
链接	Ctrl + K	Cmd + K
代码	Ctrl + `	Cmd + `

学习资源

官方规范：Markdown官方文档
GitHub指南：GitHub Markdown指南
交互式教程：Markdown Tutorial
在线预览：使用MD-PDF-WORD的实时预览功能

总结

掌握Markdown语法能让您更高效地创建格式化文档。从基础的文本格式到高级的表格和代码块，Markdown提供了丰富而简洁的语法。配合MD-PDF-WORD等工具，您可以轻松地将Markdown文档转换为专业的PDF或Word格式，满足各种文档需求。

记住，Markdown的核心理念是让您专注于内容而不是格式。选择您需要的语法，保持简洁，让您的文档既美观又易于维护。

立即实践Markdown

使用MD-PDF-WORD在线编辑器练习这些语法

打开编辑器安装扩展