VitePress博客

vitepress-theme-blog-charles7c-s2 — VitePress 博客模板

作者 Charles7c

基于 VitePress 的个人知识库与博客主题,扩展默认主题以支持文章元数据、标签归档、年度归档与个人导航页。

看看你的网站会是什么样

浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。

1 个预览视图
作者提供的预览
作者提供的预览

来自项目 README 的原始预览。

目前有 1 张原始预览,可打开完整图片查看设计细节。

截图用于了解视觉与布局,交互效果请以实际项目为准。

采集于 2026-10-01查看来源

值得关注的模板亮点

从已有项目资料中,快速了解它的特点。

01

扩展 VitePress 默认主题,提供经典博客风格适配与文章时限提醒

02

首页按发布时间分页降序展示,支持置顶,并可显示 ICP 备案号与公安备案号

03

提供标签页(按标签归档)与归档页(按年份、月份归档)

04

支持博客与专栏内容共存,并提供个人导航页整理收藏站点

05

文章 frontmatter 支持 author、authorLink、datetime、tags、top、draft 等元数据

06

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 协议。仓库提供了主页、标签页、归档页、博客与专栏内容、个人导航等页面截图。

VitePress博客

适合你的项目吗?

适用场景

  • 搭建以 Markdown 写作的个人知识库或技术博客
  • 按标签和年月归档整理已有文章
  • 在博客与专栏两种内容形态之间切换展示
  • 集中管理个人常用站点并作为导航页发布

适合人群

  • 使用 VitePress 并希望获得博客化首页与归档能力的开发者
  • 需要展示备案号、文章作者与发布时间等元数据的中文站点
  • 以 Markdown 为主要写作方式、内容以博客和专栏为主的个人站点

上手与定制指南

结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。

  1. 1

    克隆仓库后需全局安装 PNPM,再执行 pnpm install 安装依赖

  2. 2

    pnpm dev 本地运行,默认访问 http://localhost:5173;pnpm build 输出到 .vitepress/dist

  3. 3

    部署到 GitHub Pages 需在仓库设置中启用 GitHub Pages,也可部署到 Gitee Pages、Vercel、Netlify 或自有服务器

  4. 4

    文章元数据写在 frontmatter 中,datetime 为空或 draft 为 true 的文章不会显示

  5. 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

许可证原文

文章遵循[ CC 4.0 BY-SA ](http://creativecommons.org/licenses/by-sa/4.0/)版权协议,转载请附上原文出处链接和声明

README 原文
https://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/LICENSEhttps://github.com/Charles7c/vitepress-theme-blog-charles7c-s2/blob/main/README.md

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 图表、数学公式、图片预览、图片懒加载

## 部分页面截图

### 主页

![主页](./.image/screenshot/01.png)

### 标签页

![标签页](./.image/screenshot/02.png)

### 归档页

![归档页](./.image/screenshot/03.png)

### 博客、专栏内容

![博客内容](./.image/screenshot/04.png)
![专栏内容](./.image/screenshot/05.png)

### 个人导航

![个人导航](./.image/screenshot/06.png)

## 特别鸣谢

- [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
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。