Skip to content

基础功能

掌握 VitePress 的基础功能,构建专业的文档站点。

功能概览

功能说明
Markdown 扩展VitePress 对 Markdown 的扩展语法
自定义容器提示框、警告框等容器组件
Frontmatter页面级配置和元数据
站点配置config.mts 配置详解
导航栏顶部导航配置
侧边栏侧边导航配置
资源管理图片、文件等静态资源
路由路由系统和页面映射
SEO 优化搜索引擎优化配置
环境变量环境变量和配置管理
代理配置开发服务器代理设置

核心功能

Markdown 扩展

VitePress 在标准 Markdown 基础上提供了丰富的扩展:

特性说明
代码组多语言代码切换展示
行高亮代码行高亮显示
导入代码片段从文件导入代码
数学公式支持 LaTeX 公式
脚注添加脚注引用

配置系统

VitePress 的配置分为三个层级:

  1. 站点配置 - config.mts 中的全局配置
  2. 主题配置 - 主题相关的配置选项
  3. 页面配置 - Frontmatter 中的页面级配置

路由系统

VitePress 基于文件系统自动生成路由:

文件路径URL
docs/index.md/
docs/guide.md/guide
docs/guide/getting-started.md/guide/getting-started

学习路径

建议按以下顺序学习:

Markdown 扩展 → 自定义容器 → Frontmatter → 站点配置 → 导航栏/侧边栏 → 资源管理 → 路由 → SEO

下一步

完成基础功能学习后,可以继续:

贡献者

加载中...

想要成为贡献者?

在 CNB 上参与贡献