扩展 VitePress 默认主题,提供经典博客风格适配与文章时限提醒
vitepress-theme-blog-charles7c-s2 — VitePress 博客模板
作者 Charles7c
基于 VitePress 的个人知识库与博客主题,扩展默认主题以支持文章元数据、标签归档、年度归档与个人导航页。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
目前有 1 张原始预览,可打开完整图片查看设计细节。
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
首页按发布时间分页降序展示,支持置顶,并可显示 ICP 备案号与公安备案号
提供标签页(按标签归档)与归档页(按年份、月份归档)
支持博客与专栏内容共存,并提供个人导航页整理收藏站点
文章 frontmatter 支持 author、authorLink、datetime、tags、top、draft 等元数据
Markdown 扩展涵盖脚注、TODO、Mermaid 图表、数学公式、图片预览与懒加载
模板详细介绍
这是一个基于 VitePress 构建的个人知识库/博客主题,在 VitePress 默认主题基础上做了扩展。它提供经典博客风格的全局适配,首页按发布时间分页降序展示文章并支持置顶,同时可展示 ICP 备案号和公安备案号。
内容组织方面,主题提供标签页(按标签归档)、归档页(按年份和月份归档),并支持博客与专栏两类内容共存;分类页功能在 README 中已标注作废。此外还包含个人导航页,用于整理个人收藏站点。
文章元数据通过 frontmatter 定义,支持 title、author、authorLink(转载场景)、datetime、tags、top、draft 等字段;datetime 为空或 draft 为 true 的文章不会显示在内容中。Markdown 扩展包括脚注、TODO、Mermaid 图表、数学公式、图片预览与图片懒加载。
主题基于 vitepress-theme-minimalism 构建,源码采用 MIT 许可,文章内容遵循 CC 4.0 BY-SA 协议。仓库提供了主页、标签页、归档页、博客与专栏内容、个人导航等页面截图。
适合你的项目吗?
适用场景
- 搭建以 Markdown 写作的个人知识库或技术博客
- 按标签和年月归档整理已有文章
- 在博客与专栏两种内容形态之间切换展示
- 集中管理个人常用站点并作为导航页发布
适合人群
- 使用 VitePress 并希望获得博客化首页与归档能力的开发者
- 需要展示备案号、文章作者与发布时间等元数据的中文站点
- 以 Markdown 为主要写作方式、内容以博客和专栏为主的个人站点
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
克隆仓库后需全局安装 PNPM,再执行 pnpm install 安装依赖
- 2
pnpm dev 本地运行,默认访问 http://localhost:5173;pnpm build 输出到 .vitepress/dist
- 3
部署到 GitHub Pages 需在仓库设置中启用 GitHub Pages,也可部署到 Gitee Pages、Vercel、Netlify 或自有服务器
- 4
文章元数据写在 frontmatter 中,datetime 为空或 draft 为 true 的文章不会显示
- 5
源码为 MIT 许可,文章内容为 CC 4.0 BY-SA;演示图片、字体、图标等第三方素材需自行核对许可
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 文章内容采用 CC 4.0 BY-SA 协议:转载或改编文章时必须注明原作者与原文出处链接,并以相同协议(BY-SA)共享衍生内容;该限制仅适用于文章内容,不影响 MIT 许可的源码使用。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
https://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/LICENSEhttps://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/README.md文章遵循[ CC 4.0 BY-SA ](http://creativecommons.org/licenses/by-sa/4.0/)版权协议,转载请附上原文出处链接和声明
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 87 / 100
- 技术栈
- VitePress
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-01-28
- 截图检查日期
- 2026-10-01
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 VitePress。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: 8382ba5ce76859b357a12612d71b261cc57ab4ce11266f51c465b79cb7c81313
2026-10-01T04:05:36.080Z
来源文件 / 仓库# vitepress-theme-blog-charles7c-s2
<a href="http://creativecommons.org/licenses/by-sa/4.0/" target="_blank">
<img src="https://img.shields.io/badge/文章%20License-CC%204.0%20BY--SA-blue.svg">
</a>
<a href="https://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/LICENSE" target="_blank">
<img src="https://img.shields.io/badge/源码%20License-MIT-blue.svg">
</a>
vitepress 知识库主题 - Charles7c 风格2。
## 快速开始
```bash
# 克隆本仓库
git clone https://github.com/Charles7c/vitepress-theme-blog-charles7c-s2
# 安装 PNPM
npm install pnpm -g
# 安装依赖
pnpm install
# dev 运行,访问:http://localhost:5173
pnpm dev
# 打包,文件存放位置:.vitepress/dist
pnpm build
# 部署
# push 到 GitHub 仓库,部署到 GitHub Pages:需要在仓库设置中启用 GitHub Pages
# 在其他平台部署, 例如:Gitee Pages、Vercel、Netlify、个人虚拟主机、个人服务器等
```
文章元数据示例:
```text
---
title: 标题
author: 作者
authorLink: 原作者链接(转载场景)
datetime: 发布时间 yyyy-MM-dd HH:mm
category: 分类(已作废)
tags:
- 标签一
- 标签二
top: 是否置顶
draft: 是否为草稿(datetime 为空或 draft 为 true 将不显示在内容中)
---
```
## 已扩展功能(持续优化细节)
- [x] 全局经典博客主题适配,并支持文章时限提醒
- [x] 博客主页:按发布时间分页降序展示博客内容,支持置顶,支持展示 ICP 备案号和公安备案号
- [x] 标签页:按标签归档
- [x] 归档页:按年份、月份归档
- [x] ~~分类页:按分类归档~~
- [x] 支持博客、专栏内容共存
- [x] 个人导航:个人收藏站点
- [x] Markdown 扩展:FootNote、TODO、Mermaid 图表、数学公式、图片预览、图片懒加载
## 部分页面截图
### 主页

### 标签页

### 归档页

### 博客、专栏内容


### 个人导航

## 特别鸣谢
- [vuejs/vitepress](https://github.com/vuejs/vitepress)
- [vitepress-theme-minimalism](https://github.com/izhichao/vitepress-theme-minimalism):一个极简的 VitePress 博客主题(本主题基于该主题构建,感谢作者)
- [vitepress-theme-blog-charles7c-s1](https://github.com/Charles7c/vitepress-theme-blog-charles7c-s1):vitepress 知识库主题 - Charles7c 风格1
- ......
## License
- 文章遵循[ CC 4.0 BY-SA ](http://creativecommons.org/licenses/by-sa/4.0/)版权协议,转载请附上原文出处链接和声明
- 源码遵循 [MIT](https://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/LICENSE) 许可协议
- Copyright © 2026 Charles7c
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

sugar-blog
✍️📚我写博客的地方🤪🤪🤪记录随笔与学习笔记,仓库包含:博客内容,博客主题、博客模板、vitepress离线全文搜索插件、VitePress RSS 支持插件,图片预览插件;a blog theme use vi…
VitePress · 博客

vitepress-nav-template
基于 VitePress 的个人前端导航页面模板
VitePress · 博客

vitepress-blog-pure
a vitepress theme for blog, demo ↓
VitePress · 博客

vitepress-blog-starter
Vitepress Blog Starter Template
VitePress · 博客

vitepress-theme-trigger
Blog theme for VitePress with Tailwind CSS. 為建立部落格而生的 VitePress 主題
VitePress · 博客

KiwiBlog
一个分享日常的博客,这个平台上可以找到很多有趣的博客内容 🥝
VitePress · 博客
