Extends the default VitePress theme with classic blog-style adaptation and article time reminders
VitePressBlog
vitepress-theme-blog-charles7c-s2 — VitePress Blog Template
By Charles7c
A personal knowledge base and blog theme built on VitePress that extends the default theme to support article metadata, tag archives, yearly archives, and a personal navigation page.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Author preview
Author-provided preview
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-01View source
What stands out
A quick read of the recorded project description.
Homepage displays articles in reverse chronological order with pagination, supports pinning, and can display ICP and public security filing numbers
Provides tag pages (archiving by tag) and archive pages (archiving by year and month)
Supports coexistence of blog and column content, and provides a personal navigation page for organizing bookmarked sites
Article frontmatter supports metadata such as author, authorLink, datetime, tags, top, and draft
Markdown extensions cover footnotes, TODO, Mermaid diagrams, math formulas, image preview, and lazy loading
Template Details
This is a personal knowledge base/blog theme built on VitePress, extending the default VitePress theme. It provides global adaptation for a classic blog style: the homepage displays articles in reverse chronological order with pagination and supports pinning, and it can display an ICP filing number and a public security filing number.
For content organization, the theme provides tag pages (archiving by tag) and archive pages (archiving by year and month), and supports coexistence of blog and column content types; the category page feature is marked as deprecated in the README. It also includes a personal navigation page for organizing bookmarked sites.
Article metadata is defined via frontmatter and supports fields such as title, author, authorLink (for reposted content), datetime, tags, top, and draft; articles with an empty datetime or draft set to true are not displayed in the content. Markdown extensions include footnotes, TODO, Mermaid diagrams, math formulas, image preview, and image lazy loading.
The theme is built on vitepress-theme-minimalism. The source code is under the MIT license, and article content follows the CC 4.0 BY-SA agreement. The repository provides screenshots of the homepage, tag pages, archive pages, blog and column content, and the personal navigation page.
VitePressBlog
Is it right for your project?
Use Cases
- Building a personal knowledge base or technical blog written in Markdown
- Organizing existing articles with tag and year-month archives
- Switching between blog and column content formats
- Centrally managing frequently used personal sites and publishing them as a navigation page
Suitable For
- Developers using VitePress who want a blog-style homepage and archiving capabilities
- Chinese-language sites that need to display filing numbers, article authors, and publish times as metadata
- Personal sites that primarily use Markdown for writing and focus on blog and column content
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, install PNPM globally, then run pnpm install to install dependencies
- 2
Run pnpm dev locally, accessible by default at http://localhost:5173; pnpm build outputs to .vitepress/dist
- 3
To deploy to GitHub Pages, enable GitHub Pages in the repository settings; you can also deploy to Gitee Pages, Vercel, Netlify, or your own server
- 4
Article metadata is written in frontmatter; articles with an empty datetime or draft set to true are not displayed
- 5
The source code is MIT licensed, article content is CC 4.0 BY-SA; third-party assets such as demo images, fonts, and icons require separate license verification
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Article content is under the CC 4.0 BY-SA agreement: when reposting or adapting articles, you must attribute the original author and link to the original source, and share derivative content under the same agreement (BY-SA); this restriction applies only to article content and does not affect use of the MIT-licensed source code.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
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/)版权协议，转载请附上原文出处链接和声明
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-01. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 87 / 100
- Technologies
- VitePress
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-01-28
- Screenshot last checked
- 2026-10-01
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies VitePress as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 8382ba5ce76859b357a12612d71b261cc57ab4ce11266f51c465b79cb7c81313
2026-10-01T04:05:36.080Z
Source file / repository# 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
Explore similar templates
Compare previews and descriptions within the same stack and category.
sugar-blog
A VitePress-based personal blog monorepo that separates blog content, the reusable @sugarat/theme theme, shared utilities, and a creation template, and also maintains plugins for image preview, pagefind offline full-text search, RSS, 51.la analytics, announcements, back-to-top, product cards, and comments.
VitePress · Blog
vitepress-nav-template
A personal front-end navigation page template built on VitePress, created by maomao1996 under the MIT license.
VitePress · Blog
vitepress-blog-pure
A minimalist VitePress blog theme used by copying files into the project root. It provides post lists, tags, archives, local search, and Giscus comments, with posts placed in the posts directory and title required in frontmatter.
VitePress · Blog
vitepress-blog-starter
A VitePress-based blog starter template with runnable example content for posts and authors, blog logic organized through Composables, UnoCSS styling, and VitePress's built-in local search. It uses pnpm for installation, development, and build, and the repository is MIT licensed.
VitePress · Blog
vitepress-theme-trigger
vitepress-theme-trigger is a blog theme for VitePress built with Tailwind CSS, released under the MIT license.
VitePress · Blog
KiwiBlog
KiwiBlog is a Chinese personal blog template built on VitePress for publishing daily shares and articles.
VitePress · Blog