Markdown（MD）常用语法讲解

Markdown（MD）常用语法讲解，核心需求是内容清晰、实用，适合团队成员快速掌握并能直接应用在日常工作中。

下面我为你整理了一份结构完整、重点突出的 Markdown 常用语法讲解，既适合讲授，也可以作为团队的速查手册：

Markdown 常用语法快速上手

Markdown 是一种轻量级标记语言，用简单的符号就能实现文本格式化，无需复杂的排版操作，广泛用于文档编写、笔记记录、README 文件等场景。

一、基础文本格式

1. 标题

使用#表示标题层级，#数量越多，标题级别越低（1-6 级），#与标题文字之间需保留一个空格。

# 一级标题（常用作文档大标题） ## 二级标题（常用作章节标题） ### 三级标题（常用作小节标题） #### 四级标题 ##### 五级标题 ###### 六级标题

效果：

一级标题

二级标题

三级标题

2. 字体样式

3. 分隔线

使用 3 个及以上的-、*或_实现，推荐用-，前后空行更美观。

--- *** ___

效果：

二、列表

1. 无序列表

使用*、+或-开头，符号与文字之间保留一个空格，支持嵌套。

- 项目1 - 项目2 - 子项目2.1 - 子项目2.2 + 项目3 * 项目4

效果：

• 项目1
• 项目2
  • 子项目2.1
  • 子项目2.2

• 项目3

• 项目4

2. 有序列表

使用数字+.开头，数字顺序不影响显示效果，支持嵌套。

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

效果：

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

3. 任务列表

使用- [ ]表示未完成，- [x]表示已完成（注意括号内的空格）。

- [ ] 梳理需求文档 - [x] 完成接口开发 - [ ] 进行联调测试

效果：

• 梳理需求文档
• 完成接口开发
• 进行联调测试

三、链接与图片

1. 超链接

有两种常用写法，推荐第一种（可读性更高）：

// 写法1：[链接文字](链接地址 "可选的提示文字") [GitHub](https://github.com "GitHub官网") // 写法2：行内链接（简洁） <https://www.baidu.com>

效果：
GitHub
https://www.baidu.com

2. 图片

语法与链接类似，仅多一个!，支持本地图片或网络图片：

// 基础写法：![图片描述（可空）](图片地址) ![示例图片](https://picsum.photos/200/100) // 进阶：指定图片尺寸（部分编辑器支持） <img src="https://picsum.photos/200/100" width="100">

效果：

四、代码相关

1. 行内代码

使用反引号`包裹代码片段，适合标注单个命令、变量等。

使用 `npm install` 安装依赖，核心变量是 `userInfo`。

效果：
使用npm install安装依赖，核心变量是userInfo。

2. 代码块

使用 3 个反引号 `` `````包裹多行代码，指定语言可实现语法高亮：

```javascript // JavaScript 示例 function sayHello(name) { console.log(`Hello, ${name}!`); } sayHello("团队成员");

# Python 示例defsay_hello(name):print(f"Hello,{name}!")say_hello("团队成员")

**效果：** ```javascript // JavaScript 示例 function sayHello(name) { console.log(`Hello, ${name}!`); } sayHello("团队成员");

# Python 示例defsay_hello(name):print(f"Hello,{name}!")say_hello("团队成员")

五、表格

使用|分隔列，-分隔表头和内容，:可控制对齐方式：

| 姓名 | 岗位 | 负责模块 | |------|------|----------| | 张三 | 前端 | 页面开发 | | 李四 | 后端 | 接口开发 | // 带对齐方式的表格 | 姓名 | 岗位 | 负责模块 | |:---- |:---: |--------: | | 张三 | 前端 | 页面开发 | | 李四 | 后端 | 接口开发 | // 说明：`:----` 左对齐，`:---: ` 居中，`----:` 右对齐

效果：

六、其他常用语法

1. 引用

使用>表示引用，支持多层嵌套：

> 一级引用：团队协作的核心是沟通 >> 二级引用：及时同步进度，避免信息差

效果：

一级引用：团队协作的核心是沟通

二级引用：及时同步进度，避免信息差

2. 脚注

用于对文本补充说明，不影响正文阅读：

Markdown 是轻量级标记语言[^1]，非常适合团队文档编写。 [^1]: 由 John Gruber 于 2004 年创建。

效果：
Markdown 是轻量级标记语言¹，非常适合团队文档编写。

总结

1. Markdown 核心优势是简单易记、轻量化，常用语法仅需记住「标题#、列表-/*、链接、代码`/```」这几类核心符号即可满足日常需求；
2. 团队使用时优先统一「标题层级、列表样式、代码块语言标注」等规范，保证文档风格一致；
3. 不同编辑器（如 Typora、VS Code、语雀）对 Markdown 的支持略有差异，优先选择团队统一的工具，避免格式兼容问题。