概述

2025-03-01

408 words

2 min

VitePress Theme Mild (以下简称Mild Theme), 是一个且具备丰富能力的 VitePress 主题, 它基于默认主题开发, 完全兼容默认主题配置, 并在此基础上进行扩展, 加入了更多可自定义的配置项, 以及丰富的markdown能力, 并额外提供了更多布局, 例如: blog、tag. 帮助快速搭建博客或技术文档.

为什么开发这个主题

开发VitePress主题的初衷

计划 & 支持

以下是目前已经支持或计划支持的能力:

布局

• 博客页布局: blog
• 标签页布局: tag
• 项目展示页布局: project
• 时间线页布局: timeline
• 个人介绍页布局: profile
• 技术文档主页布局: site

Markdown能力

• 图片预览
• BiliBili视频播放器
• Github Task Checkbox, 与Github用法一致的任务列表复选框
• Tabs 面板
• Youtube视频播放器
• 内置视频播放器
• 文档内支持iconify图标

扩展能力

• 文章列表
• 文章基础信息: 发表时间、字数、阅读时间
• 自动侧边栏
• 侧边栏支持iconify图标
• 页面加载进度条
• RSS订阅
• 文章评论
• Live2D: oml2d
• 文章智能总结
• 公告通知弹窗

不打算做的功能

• 全局搜索: 默认主题提供的全局搜索已经非常好用, 所以我不打算再做这个重复的功能

案例

以下是正在使用这个主题的项目

博客案例:

• hacxy.cn

文档案例

• vitepress-theme-mild

快速开始

请阅读下一节: 快速开始