Markdown(MD)语法完全使用指南
Markdown(简称 MD)是一种轻量级标记语言,使用简单的符号即可实现文本排版、标题层级、代码展示、图片插入、表格制作等功能。
Markdown 广泛应用于个人博客、技术文档、GitHub 项目说明、知识笔记以及各类内容管理系统。
本文将从基础语法到进阶用法,带你全面了解 Markdown 的常用语法。
一、标题语法
Markdown 使用 # 符号定义标题,最多支持六级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题显示效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
二、文字样式
Markdown 支持多种文字格式,可以让文章重点更加突出。
示例:
**这是一段粗体文字**
*这是一段斜体文字*
~~这是一段删除线文字~~
***这是一段粗斜体文字***
这是一段包含 `代码片段` 的文本。三、段落与换行
Markdown 中,连续的文字通常属于同一个段落。
如果需要另起一段,需要在两段文字之间空一行。
这是第一段文字。
这是第二段文字。
这是第三段文字。如果需要强制换行,可以在行尾添加两个空格,或者使用 HTML 的 <br> 标签(取决于编辑器支持情况)。
第一行文字
第二行文字四、列表语法
Markdown 支持无序列表、有序列表以及任务清单。
1. 无序列表
使用 -、+ 或 * 创建无序列表。
- 苹果
- 香蕉
- 橘子显示效果:
苹果
香蕉
橘子
2. 有序列表
使用数字加英文句点创建有序列表。
1. 第一步:准备材料
2. 第二步:开始制作
3. 第三步:完成任务显示效果:
第一步:准备材料
第二步:开始制作
第三步:完成任务
3. 嵌套列表
通过缩进可以创建多级列表。
- 前端开发
- HTML
- CSS
- JavaScript
- 后端开发
- Java
- Python4. 任务清单
使用 [ ] 和 [x] 创建待办事项。
- [x] 完成网站首页
- [x] 完成文章排版
- [ ] 优化移动端适配
- [ ] 发布正式版本显示效果:
完成网站首页
完成文章排版
优化移动端适配
发布正式版本
五、引用语法
使用 > 符号可以创建引用内容,常用于名言、提示、文章摘要等场景。
> 生活不是等待风暴过去,而是学会在雨中跳舞。显示效果:
生活不是等待风暴过去,而是学会在雨中跳舞。
也可以使用多级引用:
> 一级引用
>
> > 二级引用
> >
> > > 三级引用六、代码块语法
Markdown 支持行内代码和多行代码块。
1. 行内代码
使用一对反引号包裹代码。
这是一个 `console.log()` 示例。2. 多行代码块
使用三个反引号包裹代码,并可以指定代码语言。
```javascript
function hello() {
console.log("Hello Markdown!");
}
```显示效果:
function hello() {
console.log("Hello Markdown!");
}常见代码语言:
七、链接语法
使用以下格式创建超链接:
[链接名称](链接地址)示例:
[访问百度](https://www.baidu.com)
[访问 GitHub](https://github.com)显示效果:
如果希望鼠标悬停时显示提示文字,可以使用:
[访问 GitHub](https://github.com "全球知名代码托管平台")八、图片插入
Markdown 使用以下语法插入图片:
示例:
其中:
!:表示插入图片。图片描述:图片无法加载时显示的替代文字。图片地址:图片的网络地址或相对路径。
如果需要调整图片大小,可以根据博客平台的支持情况使用 HTML:
<img src="图片地址" width="500" alt="示例图片">九、表格语法
Markdown 可以通过 | 和 - 快速创建表格。
| 名称 | 类型 | 说明 |
|---|---|---|
| HTML | 标记语言 | 网页结构 |
| CSS | 样式语言 | 网页美化 |
| JavaScript | 编程语言 | 网页交互 |显示效果:
表格对齐方式
可以通过冒号控制内容的对齐方式。
| 左对齐 | 居中对齐 | 右对齐 |
|:---|:---:|---:|
| 内容A | 内容B | 内容C |
| 内容D | 内容E | 内容F |十、分割线语法
使用三个或更多的 -、* 或 _ 可以创建分割线。
---
***
___显示效果:
十一、转义字符
如果需要显示 Markdown 本身的特殊符号,可以在符号前添加反斜杠 \。
例如:
\*这里不会变成斜体\*
\# 这里不会变成标题
\`这里不会变成代码\`常见需要转义的符号:
十二、HTML 扩展语法
部分 Markdown 编辑器支持直接嵌入 HTML,可以实现更多排版效果。
1. 文字颜色
<span style="color:red;">这是一段红色文字</span>2. 文字居中
<p align="center">这是一段居中的文字</p>3. 图片居中
<p align="center">
<img src="图片地址" width="400">
</p>4. 折叠内容
<details>
<summary>点击展开详细内容</summary>
这里是隐藏的内容。
</details>注意:HTML 扩展语法并非所有 Markdown 平台都支持,具体效果取决于编辑器和渲染引擎。
十三、数学公式
如果编辑器支持 LaTeX 数学公式,可以使用 $ 或 $$ 编写数学表达式。
行内公式:
这是一个数学公式:$E=mc^2$这是一个数学公式:
独立公式:
$$
a^2+b^2=c^2
$$效果:
十四、常用特殊符号
Markdown 可以直接输入 Unicode 特殊字符,也可以根据平台支持情况使用 HTML 实体。
十五、Markdown 常用语法速查表
下面整理了一份日常写博客时经常使用的 Markdown 语法,建议收藏。
十六、推荐 Markdown 编辑器
如果你经常使用 Markdown 编写博客、技术文档或个人笔记,可以尝试以下工具。
1. Typora
Typora — Markdown as WYSIWYG as it can get | by Martin Eder | Medium
一款简洁美观的 Markdown 编辑器,支持实时预览、图片管理和多种导出格式。
2. Obsidian
How to use Obsidian with Claude Code | by Algo Insights | Coding Nexus | Jan, 2026 | Medium
适合搭建个人知识库,支持双向链接、标签管理以及丰富的插件生态。
3. Visual Studio Code
How to Preview Markdown in Visual Studio Code
适合开发者使用,支持 Markdown 编辑、实时预览以及丰富的扩展插件。
官网:https://code.visualstudio.com/
结语
Markdown 的优势在于简单、高效、易维护。掌握以上语法,基本就可以满足日常博客写作、技术文档编写和知识整理的需求。
对于个人博客而言,合理使用标题、引用、代码块、图片和表格,不仅能让文章结构更加清晰,也能提升读者的阅读体验。
好的排版不只是让文章更漂亮,更是让知识更容易被理解和传播。
文章作者:LucianZ · Markdown 入门与使用指南
18小时前