首页/Markdown
该文更新于：2026-03-01

本文主要用于占位及测试网站Markdown。

1. 信息框 (Custom Containers) ​

本站基于 VitePress 构建，支持标准的 Markdown 语法与一些扩展功能。

VitePress 内置了多种信息框语法，用于突出显示不同类型的内容：

语法用途示例
::: info信息提示展示一般性信息
::: tip提示建议提供有用的提示
::: warning警告注意提醒用户注意
::: danger危险警告强调严重问题
::: details折叠详情可展开/收起的内容

语法格式：

markdown
:::info
这里是信息内容
:::

:::tip 自定义标题
这里是带自定义标题的提示
:::

INFO

这

只

是

WARNING

一

DANGER

条

Details

演示

2. 代码块语法高亮 ​

使用三个反引号包裹代码块，并指定语言即可获得语法高亮：

markdown
```python
def hello():
    print("Hello, World!")
```

支持的语言包括：javascript、typescript、python、html、css、bash、yaml 等。

代码块高级功能 ​

行号高亮：在代码块后添加 {行号} 可以高亮特定行：

markdown
```js{2,4-6}
function calculateTotal(items) {
  let total = 0
  for (const item of items) {
    total += item.price * item.quantity
  }
  return total
}
```

实际效果：

js
function calculateTotal(items) {
  let total = 0
  for (const item of items) {
    total += item.price * item.quantity
  }
  return total
}

代码组：使用 ::: code-group 可以并排展示多个版本的代码，不过代码组的语法高亮经过验证这里只有bash与yaml支持。

图 3

bash
pnpm add vue
bash
yarn add vue

示例：

据结果的不同，你将走向一条分支路线：

bash
恭喜你，继续下一步吧
yaml
很遗憾，你要再加把劲

3. 表格 ​

使用管道符 | 和连字符 - 创建表格：

markdown
| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

表格示例 ​

功能对比表：

功能基础版专业版企业版
用户数15无限制
存储空间5GB50GB500GB
API 调用100/天10,000/天100,000/天
技术支持社区邮件24/7 专属
价格免费$9.9/月$99/月

版本发布记录：

版本发布日期主要更新状态
v3.0.02026-03-01全新 UI 设计、性能优化✅ 最新
v2.5.02026-02-15添加暗色模式、修复 Bug📦 稳定版
v2.0.02026-01-10重构核心模块、API 变更⚠️ 维护中
v1.0.02025-12-01初始版本发布❌ 已停止

4. Emoji 表情 ​

可以直接使用 :emoji: 语法插入表情符号，例如：

  • :smile: → 😄
  • :heart: → ❤️
  • :rocket: → 🚀

更多常用表情：

  • :tada: → 🎉 庆祝
  • :bulb: → 💡 灵感
  • :books: → 📚 文档
  • :wrench: → 🔧 配置
  • :warning: → ⚠️ 警告
  • :white_check_mark: → ✅ 完成
  • :x: → ❌ 错误
  • :hourglass: → ⌛ 进行中

5. 图片与链接 ​

标准 Markdown 图片和链接语法：

markdown
[链接文字](https://example.com)
[图片描述](图片路径.jpg)

带标题的图片 ​

markdown
[这是一张示例图片](image.png "鼠标悬停时显示的标题")

7. 任务列表 ​

使用 - [ ] 和 - [x] 创建任务列表：

项目开发进度：

  • [x] 完成需求分析
  • [x] 设计数据库结构
  • [x] 搭建项目框架
  • [ ] 实现用户认证模块
  • [ ] 开发核心业务功能
  • [ ] 编写单元测试
  • [ ] 部署上线

每周任务：

  • [x] 周一：团队会议
  • [ ] 周二：代码审查
  • [ ] 周三：功能开发
  • [ ] 周四：测试验证
  • [ ] 周五：发布上线

8. 标题锚点 ​

在markdown编辑器中，所有标题会自动生成锚点链接，可以通过 #标题名 直接跳转。

例如：

9. 引用块 ​

标准引用块用于引用他人内容或强调重要信息：

这是一段引用文字。 可以包含多行内容。

嵌套引用：

第一层引用

第二层引用

第三层引用

引用中嵌入其他元素：

引用中的标题 ​

引用块中可以包含标题、列表等元素：

  • 列表项 1
  • 列表项 2
python
# 甚至可以包含代码块
print("Hello from blockquote!")

11. 分隔线 ​

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