常见错误 #
概述 #
本文档整理了 Markdown 编写中的常见错误及解决方法。
语法错误 #
错误1:标题符号后无空格 #
markdown
错误:
#标题
##标题
正确:
# 标题
## 标题
错误2:强调符号不闭合 #
markdown
错误:
**未闭合的粗体
*未闭合的斜体
正确:
**粗体**
*斜体*
错误3:列表标记后无空格 #
markdown
错误:
-项目
1.项目
正确:
- 项目
1. 项目
错误4:代码块语言标识错误 #
markdown
错误:
``` javascirpt(拼写错误)
正确:
```javascript
错误5:链接语法错误 #
markdown
错误:
[链接](https://example.com(括号不匹配)
正确:
[链接](https://example.com)
格式错误 #
错误1:标题跳级 #
markdown
错误:
# 一级标题
### 三级标题(跳过了二级)
正确:
# 一级标题
## 二级标题
### 三级标题
错误2:列表嵌套缩进错误 #
markdown
错误:
- 一级
- 二级(缩进不够)
- 三级
正确:
- 一级
- 二级
- 三级
错误3:表格格式错误 #
markdown
错误:
| 列1 | 列2
|-----|-----|
| A | B
正确:
| 列1 | 列2 |
|-----|-----|
| A | B |
错误4:代码块不闭合 #
markdown
错误:
```javascript
const x = 1;
``(反引号数量不够)
正确:
```javascript
const x = 1;
text
## 内容错误
### 错误1:链接文本不描述
```markdown
错误:
点击 [这里](https://example.com)
正确:
查看 [官方文档](https://example.com)
错误2:图片无替代文本 #
markdown
错误:

正确:

错误3:代码无语言标识 #
markdown
错误:
const x = 1;
text
正确:
```javascript
const x = 1;
text
## 兼容性错误
### 错误1:使用不支持的语法
```markdown
错误(部分平台不支持):
术语
: 定义
正确(使用HTML):
<dl>
<dt>术语</dt>
<dd>定义</dd>
</dl>
错误2:数学公式语法错误 #
markdown
错误:
$E = mc^2(缺少闭合)
正确:
$E = mc^2$
编码错误 #
错误1:使用中文标点 #
markdown
错误:
# 标题(中文井号)
**粗体**(中文星号)
[链接](https://example.com)(中文括号)
正确:
# 标题
**粗体**
[链接](https://example.com)
错误2:特殊字符未转义 #
markdown
错误:
表格中使用 | 符号
正确:
表格中使用 \| 符号
结构错误 #
错误1:缺少空行 #
markdown
错误:
段落内容。
- 列表项
正确:
段落内容。
- 列表项
错误2:多个空行 #
markdown
错误:
段落一
段落二
正确:
段落一
段落二
错误3:元素前后无空行 #
markdown
错误:
内容
```javascript
code
内容
正确: 内容
javascript
code
内容
text
## 错误排查清单
- [ ] 标题符号后是否有空格
- [ ] 强调符号是否闭合
- [ ] 列表标记后是否有空格
- [ ] 代码块是否正确闭合
- [ ] 链接语法是否正确
- [ ] 表格格式是否正确
- [ ] 是否使用英文标点
- [ ] 元素前后是否有空行
## 下一步
继续学习 [风格指南](/docs/markdown/style-guide)!
最后更新:2026-03-24