Markdown 基本语法（完整版）

说明：本文内容整理自简书平台多篇 Markdown 教程，涵盖 Markdown 的核心语法规则、示例代码和注意事项。Markdown 是一种轻量级的标记语言，由 John Gruber 于 2004 年创建，目标是实现"易读易写"。

Markdown 简介

什么是 Markdown？

Markdown 是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。相比传统的 WYSIWYG（所见即所得）编辑器，Markdown 让作者专注于内容本身，而非排版。

优点

纯文本：只要支持 Markdown 的地方都能获得一样的编辑效果
操作简单：例如设置标题只需在文字前加 #，无需多步操作
格式易转：可导出 HTML、PDF 等多种格式
平台广泛：GitHub、简书、知乎、Typora 等众多平台/工具均支持

缺点

需要记忆少量语法（但 5 分钟即可上手）
部分平台不支持 Markdown 编辑模式

标题

Markdown 支持六级标题，通过在文字前加 # 实现。# 与标题文字之间建议加一个空格。

语法

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

效果

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

补充：= 和 - 标记

还可以在标题文字下方加 =（一级标题）或 -（二级标题）：

这是一级标题
============

这是二级标题
------------

段落与换行

段落：一段连续的文字，两个段落之间使用空行分隔（一个空行即表示新段落）。
换行：在行末输入两个空格然后回车，可实现换行但不分段（软换行）。

示例

这是第一段文字。这里连续书写。

这是第二段文字，与前一段之间有空行。

这是第三行（行末有两个空格）← 注意  
这是换行后的内容（仍属同一段落）。

字体样式（强调）

语法

样式	语法	示例
斜体	`内容` 或 `_内容_`	`斜体` → 斜体
粗体	`内容` 或 `__内容__`	`粗体` → 粗体
粗斜体	`*内容*` 或 `___内容___`	`*粗斜体` → 粗斜体*
删除线	`~~内容~~`	`~~删除~~` → 删除

示例代码

**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~

分割线

使用三个或三个以上的 *、-、_ 均可创建分割线。

语法

***
---
___

*****
-----

所有上述写法效果相同，均渲染为一条水平分割线。

引用

在文字前加 > 即可表示引用。引用可以嵌套（使用 >>、>>>），内部也可以使用其他 Markdown 标记。

语法

> 这是一段引用
>
> > 这是嵌套引用
> >
> > > 更深层引用

效果

这是一段引用

这是嵌套引用

更深层引用

列表

无序列表

使用 -、+、* 均可，与文字之间有一个空格。

- 列表项一
- 列表项二
- 列表项三

有序列表

使用 数字 + .，与文字之间有一个空格。

1. 第一步
2. 第二步
3. 第三步

注意：序号数字可以不连续，Markdown 会自动按顺序渲染。

列表嵌套

在子级列表前缩进三个空格或一个 Tab：

- 一级列表项
   - 二级列表项
   - 二级列表项
- 一级列表项
   1. 二级有序列表项
   2. 二级有序列表项

链接

行内链接

[链接文字](链接地址 "标题")

示例：[简书](https://www.jianshu.com)

引用式链接

将链接地址定义在文档末尾，文中通过 [文字][id] 引用：

[百度][baidu]
[谷歌][google]

[baidu]: https://www.baidu.com "百度搜索"
[google]: https://www.google.com "谷歌搜索"

自动链接

用 <> 包裹网址或邮箱，Markdown 会自动转为链接：

<https://www.example.com>
<email@example.com>

提示：Markdown 原生语法不支持在新页面打开链接。如需此功能，可直接使用 HTML 的 <a> 标签：<a href="url" target="_blank">文字</a>

图片

语法

![图片alt文字](图片地址 "图片title")

alt 文字：图片无法显示时的替代文字，也是对图片内容的解释
title：鼠标悬停在图片上时显示的提示文字（可选）

示例

![风景图](https://example.com/scenery.jpg "美丽风景")

引用式图片

![风景图][scenery]

[scenery]: https://example.com/scenery.jpg "美丽风景"

注意：大多数 Markdown 编辑器（包括简书）支持直接拖拽或粘贴上传图片。

代码

行内代码

使用一对反引号 ` 包裹代码：

使用 `print("Hello World")` 输出内容。

代码块

方式一：每行缩进 4 个空格或 1 个 Tab

    // 代码块
    function hello() {
        console.log("Hello");
    }

方式二：使用三个反引号围栏（推荐），可指定语言实现语法高亮

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

表格

语法

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第一行：表头
第二行：分隔符（---），定义对齐方式
- 默认左对齐：---
- 居中对齐：:---:
- 右对齐：---:
后续行：表格数据

示例

姓名|语文|数学|英语
---|:---:|:---:|---:
张三|95|88|92
李四|87|93|90
王五|91|85|89

效果

姓名	语文	数学	英语
张三	95	88	92
李四	87	93	90
王五	91	85	89

脚注

为名词提供注释，注释内容将显示在文章末尾。

语法

这是一段需要注释的文字[^注1]。

[^注1]: 这里是注释内容。

注意：并非所有 Markdown 平台都支持脚注（如简书不支持）。

转义字符

使用反斜杠 \ 转义原本具有特殊含义的字符，使其显示为普通文字。

可转义字符

\   反斜杠
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  圆括号
#   井号
+   加号
-   减号
.   点号
!   感叹号

示例

\# 这里不是标题，只是一个带井号的文字
\*\*这不是粗体\*\*

Markdown 与 HTML 的关系

Markdown 是书写格式，HTML 是发布格式。
Markdown 中可以直接嵌入 HTML 标签。
区块元素（如 <div>、<table>、<pre> 等）前后需空行，且不可缩进。
行内元素（如 <span>、<cite>、<del> 等）可随意使用。
在 HTML 区块标签内部，Markdown 语法无效。

常见问题与注意事项

标题 # 后建议加空格——这是标准写法，加空格可确保在所有平台上正确渲染。
列表后需要空行——列表结束后建议加空行，否则后续内容可能被误认为列表项。
在列表内分段——列表项内如需包含多个段落，段落前需缩进 4 个空格或 1 个 Tab。
代码块内的 Markdown 标记不会被解析——代码和代码块中的特殊字符会自动转义。
表格中 | 两侧的空格不是必需的——加空格只是为了让源码更美观，不影响渲染。
简书不支持的功能（部分 Markdown 平台有差异）：
- [TOC] 目录索引
- LaTeX 数学公式
- 流程图、时序图、甘特图、Mermaid 图
- 定义列表、待办事项（Todo list）
- 代码块行号

总结

Markdown 语法简单直观，日常写作中掌握以下核心规则即可：

语法	作用
`#`	标题（1-6级）
`` `` `**`	斜体、粗体、粗斜体
`~~`	删除线
`>`	引用
`-` `*` `1.`	无序/有序列表
` / ```	行内代码 / 代码块
`[文字](url)`	超链接
`![alt](url)`	图片
`	`
`---` `***`	分割线

本文内容整理自"简书"平台多篇 Markdown 教程文章，感谢原作者们的分享。

最后更新时间：2026 年 5 月 19 日

分享

Markdown 基本语法