Skip to content

Markdown 语法简洁整理

基本信息

  • 轻量级标记语言
  • VS Code 插件推荐:1. Markdown Preview Enhanced(可转换为 PDF、HTML 等)2. Markdown to Word(可直接导出 Word 文档)
  • 参考链接Markdown 教程

语法指南(仅知识点)

1. 标题---(1个#到6个#,仅左边,有空格)

  • 1-6 级别:#######
  • 只用左侧添加,不用两侧包裹

2. 段落---(空行分隔)

  • 段落之间用空行分隔

3. 分割线---(多个*)

  • 使用 ***(或 ---___,渲染效果相同)

4. 文本格式化-----(一个斜体,2个粗体,3个粗斜体,2个~~删除线)

  • 斜体*斜体*
  • 粗体**粗体**
  • 粗斜体***粗斜体***
  • 删除线~~删除线~~

5. 列表---(1.无序:*跟空格,2.有序:数字跟空格,3.嵌套:多个空格)

  • 无序列表* 后跟空格(转义 \* 可显示原样星号)
  • 有序列表:数字加 .
  • 嵌套列表:子项前加 2 或 4 个空格

6. 引用---(比代码块更高亮效果,多了>字符)

  • 使用 > 标记,可嵌套

7. 代码

  • 行内代码` 包裹
  • 代码块 包裹,可指定语言实现高亮

8. 链接---(方框是文字,括号是地址)

  • 语法:[链接名称](链接地址)

9. 图片(比链接多了!,可以预览显示)

  • 语法:![链接名称](链接地址)

10. 表格

  • | 分隔单元格,--- 作表头分割线
  • 对齐::--- 左、---: 右、:---: 居中,缺省默认左对齐

11. 任务列表

  • 未完成 - [ ],已完成 - [x]

12. HTML 标签支持---(建议只用kbd)

  • 行内标签:strongemdelinssupsubbsu
  • 结构标签:ol-liul-li;样式 style
  • kbd 标签用于高亮按键(如 Ctrl + C

13. 数学公式---(行内 $...$,块级 $$...$$)

  • 行内 $...$,块级 $$...$$

最佳实践

  • 使用 * 而不是 _ 进行文本强调
  • 使用 而不是 ~~~ ~~~ 进行代码块标记
  • 表格使用对齐标记使布局更清晰
  • 任务列表用于跟踪项目进度
  • kbd 标签在编写操作手册时非常有用

综合实例(语法参考,代码块)

以下为原始写法,便于复制对照:

markdown
# 二级标题
## 三级标题

这是一个段落。

这是换行后的内容(行尾两空格)。

*斜体* **粗体** ***粗斜体*** ~~删除线~~

---

* 无序项一
* 无序项二
  * 嵌套子项
1. 第一步
2. 第二步

> 一级引用
> > 嵌套引用

行内代码示例:`console.log("hi")`

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

| 左对齐 | 右对齐 | 居中对齐 |
| :---   |   ---: |  :---:   |
| 单元格 | 单元格 |  单元格  |

质能方程:$E=mc^2$

渲染预览(查看实际效果)

以下直接渲染,可对照上方语法看效果:

链接与图片

百度

示例图片

任务列表

  • [x] 已完成任务
  • [ ] 未完成任务

表格

功能描述状态
文本格式化支持斜体、粗体等
列表功能支持有序和无序列表
链接功能支持添加外部链接
图片功能支持插入图片
代码高亮支持代码语法高亮

联系方式

© 2026 开发速查