Skip to content

这是一份 Markdown 通用语法速查手册,覆盖了日常写作和开发文档(如 README、技术笔记)中最常用的所有语法。


Markdown 语法全示例


1. 标题(Headings)

使用 # 号,空格后接文字,共支持 6 级。

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

2. 段落与换行

  • 直接换行:段落间空一行即可。
  • 软换行:行末加 两个空格 再回车,或使用 <br> 标签。
markdown
这是第一段。

这是第二段(中间空行分隔)。

这是第一行(末尾两个空格)  
这是紧跟的下一行。

3. 文字样式(强调与修饰)

效果语法示例
加粗**文本**__文本__加粗文本
斜体*文本*_文本_斜体文本
粗斜体***文本***粗斜体
删除线~~文本~~删除线
下划线<u>文本</u>(HTML标签)下划线
行内代码`代码`System.out.println()

4. 列表(Lists)

无序列表(使用 - * +

markdown
- 苹果
- 香蕉
  - 子项(缩进 2 或 4 空格)
  - 另一个子项
- 橙子

有序列表(数字 + .

markdown
1. 第一步
2. 第二步
   1. 子步骤 2.1
   2. 子步骤 2.2
3. 第三步

任务列表(GFM 扩展,常用于 GitHub)

markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

5. 引用(Blockquotes)

使用 > 号。

markdown
> 这是一级引用。
>
> > 这是嵌套的二级引用。
> >
> > > 三级引用嵌套。

渲染效果:这是一段被引用的文本。


6. 链接与图片

行内链接

markdown
[百度](https://www.baidu.com "悬停提示文字")

引用式链接(便于复用)

markdown
[我的博客][1]
[1]: https://example.com "博客描述"

自动链接(尖括号)

markdown
<https://github.com>
<admin@example.com>

图片(语法与链接类似,前面加 !

markdown
![图片替代文字](https://example.com/image.jpg "图片标题")

7. 代码块(Code Fences)

使用三个反引号 ``` 包围,并可指定编程语言(实现语法高亮)。

markdown​
```java
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Markdown!");
    }
}

其他语言示例:
```json
{
  "name": "Markdown",
  "version": 1.0
}

8. 表格(Tables)

使用管道符 | 和横杠 - 绘制表头。冒号 : 控制对齐方式。

markdown
| 左对齐(默认) | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 苹果 | 5 元 | 水果 |
| 香蕉 | 3 元 | 水果 |
| 笔记本 | 5000 元 | 电子产品 |
左对齐(默认)居中对齐右对齐
苹果5 元水果
香蕉3 元水果
笔记本5000 元电子产品

9. 分割线(Horizontal Rules)

单独一行使用三个或以上 ---***___

markdown
---
***
___

10. 转义字符(Escaping)

特殊字符前加反斜杠 \ 可显示原本符号。

markdown
\* 这不是斜体 \*
\# 这不是标题
\[这不是链接\]\(url)

11. 高级扩展(GFM / 常见平台支持)

脚注(Footnote)

markdown
这是带脚注的文本[^1]。
[^1]: 这里是脚注的具体内容。

目录跳转(锚点)

markdown
[跳转到标题](#标题名)
# 注意:标题名需转为英文小写,空格变连字符,中文可能需 URL 编码。

HTML 标签混合

Markdown 支持内嵌 HTML,可实现更复杂的排版,例如:

html
<p align="center">这是一段居中文字</p>
<kbd>Ctrl</kbd> + <kbd>C</kbd>

12. 数学公式(需平台开启支持,如 Typora / GitLab)

使用 $ 行内公式,$$ 块级公式(LaTeX 语法)。

markdown
行内公式:$E = mc^2$

块级公式:
$$
\sum_{i=1}^{n} i^2 = \frac{n(n+1)(2n+1)}{6}
$$

💡 最佳实践小贴士

  1. 列表与子项:缩进统一使用 2 或 4 空格,避免混用 Tab。
  2. 空行分隔:不同区块(如标题与正文、列表与代码块)之间建议空一行,避免渲染出错。
  3. 代码块指定语言:一定要写语言名(如 java json sql),否则没有高亮。
  4. 兼容性:某些扩展语法(如任务列表、脚注)在纯文本编辑器或旧平台可能不生效,建议根据使用平台测试。

基于 VitePress 构建