Markdown 的完整常用语法指南

Markdown 是一种轻量级标记语言,它的核心理念是**“易读易写”**。你不需要复杂的排版工具,只需要简单的符号就能让文字拥有漂亮的格式。

以下是 Markdown 的完整常用语法指南,按照功能分类罗列:


1. 标题

使用 # 号来表示标题,# 的数量代表标题的级别(共 6 级)。注意 # 后面需要加一个空格。

表格

语法 说明 效果示例
# 标题 一级标题 (通常用于文章主标题) 大标题
## 标题 二级标题 次级标题
### 标题 三级标题 小节标题
#### 标题 四级标题 ...
##### 标题 五级标题 ...
###### 标题 六级标题 ...

2. 文本样式

用于强调文字、标记重点或代码。

  • 粗体:使用两个星号 ** 或两个下划线 __ 包裹文字。
    • 输入:**这是粗体**
    • 效果:这是粗体
  • 斜体:使用一个星号 * 或一个下划线 _ 包裹文字。
    • 输入:*这是斜体*
    • 效果:这是斜体
  • 粗斜体:使用三个星号 *** 包裹。
    • 输入:***这是粗斜体***
    • 效果:这是粗斜体
  • 删除线:使用两个波浪号 ~~ 包裹。
    • 输入:~~这是删除线~~
    • 效果:这是删除线
  • 行内代码:使用反引号 包裹(通常用于标注代码片段或命令)。
    • 输入:请使用 print() 函数
    • 效果:请使用 print() 函数

3. 列表

无序列表

使用 -+* 加上空格。

- 项目 1
- 项目 2
  - 子项目 A (前面加两个空格或Tab)
  - 子项目 B

效果:

  • 项目 1
  • 项目 2
    • 子项目 A
    • 子项目 B

有序列表

使用数字加点 . 加上空格。

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

效果:

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

任务列表 (待办事项)

使用 - [ ] (未完成) 和 - [x] (已完成)。

- [x] 已完成的任务
- [ ] 待办任务

效果:

  • 已完成的任务
  • 待办任务

4. 引用

使用 > 符号。支持多层嵌套。

> 这是一段引用文本。
> > 这是嵌套的引用。

效果:

这是一段引用文本。

这是嵌套的引用。


5. 代码块

用于展示多行代码。使用三个反引号 包裹,并可在开头指定语言以实现语法高亮(如 python, java, javascript, cpp 等)。

输入:

```python
def hello():
    print("Hello, World!")
**效果:**
def hello():
print("Hello, World!")

6. 链接与图片

这两者的语法非常相似,区别在于图片前面多一个感叹号 !

  • 插入链接[链接文字](链接地址)
  • 插入图片![图片描述](图片地址)
    • 输入:![Logo](https://example.com/logo.png)
    • 效果:(显示该地址的图片)

小技巧:如果图片地址是本地文件,也可以直接拖入支持 Markdown 的编辑器中,它会自动生成路径。


7. 表格

使用 | 分隔列,使用 - 分隔表头。

  • :- 的左边表示左对齐
  • :- 的右边表示右对齐
  • : 在两边表示居中

输入:

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 |  单元格  | 单元格 |
| 内容A  |  内容B  |  内容C |

效果:

表格

左对齐 居中对齐 右对齐
单元格 单元格 单元格
内容A 内容B 内容C

8. 分割线

使用三个或以上的 *-_

输入:

---

效果:
(一条横线)


9. 转义字符

如果你想输入 Markdown 的特殊符号本身(比如你想输入 # 但不想让它变成标题),可以在符号前加反斜杠 \

  • 输入:\# 这不是标题
  • 效果: 这不是标题

📌 总结速查表

表格

功能 语法示例
标题 # H1, ## H2
粗体 **文本**
斜体 *文本*
删除线 ~~文本~~
代码 代码
链接 [文本](URL)
图片 ![描述](URL)
列表 - 项目1. 项目
引用 > 文本
表格 `

掌握以上这些,你就已经能够应对 95% 的日常写作需求了