@chunge16/vitepress-blogs-theme

A VitePress blog theme with authors, tags, archives, and a built-in setup wizard
2,200 18
vue vite markdown vitepress theme ssg blog static-site-generator
Install
npm install @chunge16/vitepress-blogs-theme
Latest Version:1.0.0
Vue:3
License:MIT
Last Updated:Jun 5, 2026
Links: GitHub  ·  npm
Maintainer: chungeweb

VitePress Blog Theme

npm license

A VitePress theme that turns a documentation site into a polished blog, without giving up the simplicity of Markdown or the flexibility of the default VitePress experience.

VitePress Blog Theme Preview

Why This Theme

VitePress is excellent for content-driven sites, but building a real blog on top of it still takes glue work. This theme packages the common pieces you usually end up rebuilding yourself, so you can start with a clean blog structure and keep customizing as your site grows.

It is a good fit if you want to:

  • publish blog posts with Markdown
  • organize content by authors, tags, categories, and archives
  • keep the VitePress developer experience
  • extend the site with your own Vue components and theme logic

Features

  • Blog index, post pages, author pages, tag pages, and archive pages
  • Markdown-first workflow with frontmatter-driven content
  • Built on top of the default VitePress theme
  • Tailwind CSS integration for easier styling
  • Optional Giscus comments support
  • Setup wizard to scaffold the initial blog structure

Quick Start

1. Install

pnpm add -D vitepress @chunge16/vitepress-blogs-theme tailwindcss @tailwindcss/vite

npm install -D vitepress @chunge16/vitepress-blogs-theme tailwindcss @tailwindcss/vite

yarn add -D vitepress @chunge16/vitepress-blogs-theme tailwindcss @tailwindcss/vite

2. Scaffold the site

pnpm vitepress-blog-init

npx vitepress-blog-init

yarn vitepress-blog-init

3. Start development

pnpm run docs:dev

Documentation

What Gets Generated

The setup wizard creates the essential structure for a VitePress-powered blog:

docs/
  .vitepress/
    config.js
    theme/
      index.js
  blog/
    authors/
    posts/
    archives.md
    index.md
    tags.md

From there, you can keep the default setup or continue extending it like any other VitePress theme.

Customization

This theme extends the default VitePress theme instead of replacing the VitePress workflow. That means you can still:

  • add custom Vue components
  • register enhanceApp logic
  • override styles
  • evolve the site into a docs-and-blog hybrid

Credits

Inspired by ideas and implementations from:

Demo blog content is created by vitepressblog.

Changelog

Release notes are available in CHANGELOG.md.

License

MIT

Copyright (c) 2023-present, chunge

Related Packages

vitepress-theme-teek

vitepress-theme-teek

26,382 353
blog markdown theme vite vitepress vue doc ui
@jcamp/vitepress-blog-theme

VitePress easy to use blog theme

958 28
blog theme vite vitepress vue
@composy/longpress

LDesign 文档系统 - 支持 Vue/React 组件渲染、主题系统、插件系统的现代化文档框架

504
markdown static-site-generator theme vitepress vue documentation plugin react
vitepress-theme-vuejsblog

A personal-blog theme for VitePress in the style of blog.vuejs.org

1,154 1
blog theme vitepress vue vitepress-theme
kawapress

A Vue-centric static site generator

712 8
markdown ssg vite vue documentation

Version History

Version Released Vue License
1.0.0 ^3.5.35 MIT
0.5.6 ^3.3.9 MIT
0.5.5 ^3.3.9 MIT
0.5.3 ^3.3.9 MIT
0.5.2 ^3.3.9 MIT