这是一篇包含 Markdown 所有常用及扩展语法的综合演示文章。你可以将其作为速查手册或测试渲染效果的样本。
Markdown 全语法演示文档#
1. 标题体系#
一级标题 (H1)#
二级标题 (H2)#
三级标题 (H3)#
四级标题 (H4)#
五级标题 (H5)#
六级标题 (H6)#
💡 提示:
#与标题文字之间必须有一个空格。
2. 文本样式与内联元素#
这是普通段落。Markdown 支持丰富的内联格式:
- 粗体文本 或 双下划线粗体
- 斜体文本 或 单下划线斜体
- 粗斜体 或 双下划线粗斜体
删除线文本行内代码 Inline Code- ==高亮文本== (部分渲染器支持)
- 上标:X^2^ / 下标:H
2O (扩展语法) - 超链接
- 自动链接:
- Emoji 表情:🎉 ✅ 🚀 😊
3. 列表#
无序列表#
- 项目 A
- 项目 B
- 嵌套子项 B1
- 嵌套子项 B2
- 更深层级 C1
- 项目 C
有序列表#
- 第一步
- 第二步
- 子步骤 2.1
- 子步骤 2.2
- 第三步
任务列表(复选框)#
- 已完成的任务
- 未完成的任务
- 另一个待办事项
定义列表#
- 术语一
- 术语一的定义内容
- 术语二
- 术语二的定义内容
- 可以有多个定义
4. 引用与块级元素#
普通引用#
这是一段引用文字。
这是嵌套引用。
引用中可以包含 粗体、斜体、
代码等格式。 — 引用来源
警告/提示块(GitHub Flavored Markdown 扩展)#
Note
这是一个 NOTE 提示块,用于补充信息。
Tip
这是一个 TIP 提示块,用于提供建议。
Important
重要信息提示块。
Warning
警告提示块。
Caution
危险/严重警告提示块。
5. 代码展示#
行内代码#
使用 print("Hello World") 输出问候语。
代码块(带语法高亮)#
# Python 示例
def fibonacci(n: int) -> list[int]:
"""生成斐波那契数列"""
if n <= 0:
return []
seq = [0, 1]
while len(seq) < n:
seq.append(seq[-1] + seq[-2])
return seq[:n]
if __name__ == "__main__":
print(fibonacci(10)){
"name": "markdown-demo",
"version": "1.0.0",
"features": ["tables", "tasklists", "syntax-highlighting"]
}代码块(显示文件名)#
export function formatDate(date) {
return new Intl.DateTimeFormat('zh-CN').format(date);
}6. 表格#
| 左对齐 | 居中对齐 | 右对齐 | 默认对齐 |
|---|---|---|---|
| 单元格 | 单元格 | 单元格 | 单元格 |
| 粗体 | 斜体 | 代码 | |
| 长文本内容会自动换行显示 | 短文本 | 123.45 | ✅ |
| 链接 | 🎉 | $99.99 | 普通文本 |
💡 表格分隔行中至少需要三个连字符
---,冒号:控制对齐方式。
7. 分隔线#
以下三种写法效果相同:
8. 图片与媒体#
基本图片#
图片链接#
HTML 图片标签(精确控制尺寸)#
9. 脚注与数学公式#
脚注#
数学公式(LaTeX)#
行内公式:质能方程 $E = mc^2$,以及欧拉公式 $e^{i\pi} + 1 = 0$。
块级公式:
$$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$$$ f(x) = \frac{1}{\sigma\sqrt{2\pi}} e^{-\frac{(x-\mu)^2}{2\sigma^2}} $$10. HTML 混用#
Markdown 允许直接嵌入 HTML:
这是被折叠的内容区域。
- 支持列表
- 支持 所有 Markdown 语法
- 支持
代码块
| 列1 | 列2 |
|---|---|
| A | B |
11. 转义字符#
使用反斜杠 \ 转义特殊符号:
* #
$$ $$$ $ ` _ | \ > - . !
12. 目录(TOC)#
部分编辑器/平台支持自动生成目录:
[TOC]或手动编写:
- 1. 标题体系
- 2. 文本样式与内联元素
- 3. 列表
- 4. 引用与块级元素
- 5. 代码展示
- 6. 表格
- 7. 分隔线
- 8. 图片与媒体
- 9. 脚注与数学公式
- 10. HTML 混用
- 11. 转义字符
- 12. 目录(TOC)
📋 语法速查表#
| 语法 | 写法 | 效果 |
|---|---|---|
| 粗体 | **text** | text |
| 斜体 | *text* | text |
| 删除线 | ~~text~~ | |
| 行内代码 | `code` | code |
| 链接 | [text](url) | text |
| 图片 |  | |
| 引用 | > text | > text |
| 水平线 | --- | — |
| 任务列表 | - [x] done | ☑ done |
| 脚注 | [^1] | 1 |
| 行内公式 | $E=mc^2$ | $E=mc^2$ |
📝 说明:不同 Markdown 解析器(如 CommonMark、GFM、Pandoc、Typora 等)对扩展语法的支持程度不同。本文档涵盖了主流解析器广泛支持的语法集合。实际使用时请以目标平台的渲染效果为准。