常见错误 #

概述 #

本文档整理了 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
错误:
![](image.png)

正确:
![产品截图](image.png)

错误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