基础功能
掌握 VitePress 的基础功能,构建专业的文档站点。
功能概览
| 功能 | 说明 |
|---|---|
| Markdown 扩展 | VitePress 对 Markdown 的扩展语法 |
| 自定义容器 | 提示框、警告框等容器组件 |
| Frontmatter | 页面级配置和元数据 |
| 站点配置 | config.mts 配置详解 |
| 导航栏 | 顶部导航配置 |
| 侧边栏 | 侧边导航配置 |
| 资源管理 | 图片、文件等静态资源 |
| 路由 | 路由系统和页面映射 |
| SEO 优化 | 搜索引擎优化配置 |
| 环境变量 | 环境变量和配置管理 |
| 代理配置 | 开发服务器代理设置 |
核心功能
Markdown 扩展
VitePress 在标准 Markdown 基础上提供了丰富的扩展:
| 特性 | 说明 |
|---|---|
| 代码组 | 多语言代码切换展示 |
| 行高亮 | 代码行高亮显示 |
| 导入代码片段 | 从文件导入代码 |
| 数学公式 | 支持 LaTeX 公式 |
| 脚注 | 添加脚注引用 |
配置系统
VitePress 的配置分为三个层级:
- 站点配置 -
config.mts中的全局配置 - 主题配置 - 主题相关的配置选项
- 页面配置 - Frontmatter 中的页面级配置
路由系统
VitePress 基于文件系统自动生成路由:
| 文件路径 | URL |
|---|---|
docs/index.md | / |
docs/guide.md | /guide |
docs/guide/getting-started.md | /guide/getting-started |
学习路径
建议按以下顺序学习:
Markdown 扩展 → 自定义容器 → Frontmatter → 站点配置 → 导航栏/侧边栏 → 资源管理 → 路由 → SEO下一步
完成基础功能学习后,可以继续: