Markdown 语法完全指南

这篇文章展示了 Markdown 的各种常用格式和渲染效果，可以作为写作时的参考。

标题

Markdown 支持六级标题，使用 # 符号表示：

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

文本格式

强调

• 粗体文本：使用 **文本** 或 __文本__
• 斜体文本：使用 *文本* 或 _文本_
• 粗斜体：使用 ***文本***
• 删除线：使用 ~~文本~~
• 行内代码：使用 `代码`

下划线和高亮

某些 Markdown 扩展支持：

• 下划线文本
• ==高亮文本==（部分编辑器支持）

列表

无序列表

使用 -、+ 或 * 创建无序列表：

• 第一项
• 第二项
• 第三项
  • 嵌套项 1
  • 嵌套项 2
    • 更深层嵌套

有序列表

使用数字加点创建有序列表：

1. 第一步
2. 第二步
3. 第三步
   1. 子步骤 A
   2. 子步骤 B
4. 第四步

任务列表

• 已完成的任务
• 另一个已完成的任务
• 待完成的任务
• 另一个待完成的任务

链接和图片

链接

• 行内链接：Google
• 带标题的链接：GitHub
• 自动链接：https://www.example.com
• 引用式链接：参考资料

图片

图片也可以带链接：

引用

单行引用

这是一段引用文本。

多行引用

这是第一段引用。

这是第二段引用。

— 作者名

嵌套引用

这是第一层引用

这是第二层引用

这是第三层引用

代码

行内代码

使用反引号包裹：const x = 10;

代码块

使用三个反引号创建代码块，并指定语言：

function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}

console.log(fibonacci(10)); // 55

def quick_sort(arr):
    if len(arr) <= 1:
        return arr
    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]
    return quick_sort(left) + middle + quick_sort(right)

print(quick_sort([3, 6, 8, 10, 1, 2, 1]))

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

.container {
  display: flex;
  justify-content: center;
  align-items: center;
  min-height: 100vh;
  background: linear-gradient(to right, #667eea 0%, #764ba2 100%);
}

表格

基本表格

对齐方式

复杂表格

分隔线

使用三个或更多的 -、* 或 _ 创建分隔线：

数学公式

行内公式

这是一个行内公式：(E = mc^2)，爱因斯坦的质能方程。

圆的面积公式：(A = \pi r^2)

块级公式

二次方程求根公式：

$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

欧拉公式：

$e^{i\pi} + 1 = 0$

傅里叶变换：

$F(\omega) = \int_{-\infty}^{\infty} f(t) e^{-i\omega t} dt$

脚注

这是一个带脚注的文本¹。

这是另一个脚注²。

定义列表

术语 1 : 这是术语 1 的定义

术语 2 : 这是术语 2 的定义 : 可以有多个定义

HTML 标签

Markdown 支持直接使用 HTML 标签：

Emoji 表情

支持 emoji 表情符号：

• 😀 😃 😄 😁 😆
• 🎉 🎊 🎈 🎁 🎂
• 💻 📱 ⌨️ 🖥️ 🖨️
• ✅ ❌ ⚠️ ℹ️ 🚀
• ❤️ 💙 💚 💛 🧡

键盘按键

使用 <kbd> 标签表示键盘按键：

• 保存：Ctrl + S
• 复制：Ctrl + C
• 粘贴：Ctrl + V
• 撤销：Ctrl + Z

缩写

HTML *[HTML]: Hyper Text Markup Language

CSS *[CSS]: Cascading Style Sheets

当你悬停在 HTML 或 CSS 上时，会显示完整名称（需要支持的渲染器）。

上标和下标

• 上标：X² + Y² = Z²
• 下标：H₂O，CO₂
• 化学式：C₆H₁₂O₆

引用代码文件

可以引用特定语言的代码文件：

interface User {
  id: number;
  name: string;
  email: string;
  role: 'admin' | 'user' | 'guest';
}

type UserRole = User['role'];

function isAdmin(user: User): boolean {
  return user.role === 'admin';
}

总结

以上就是 Markdown 的主要语法格式。Markdown 的设计理念是：

1. 易读易写：即使不渲染，源文件也很容易阅读
2. 纯文本：可以使用任何文本编辑器编辑
3. 可转换：可以轻松转换为 HTML 等其他格式
4. 可扩展：支持各种扩展语法

💡 提示：不同的 Markdown 渲染器可能支持的语法略有不同，建议查看具体渲染器的文档。

希望这份指南能帮助你更好地使用 Markdown 进行写作！✨