---
pageLayout: home
title: Vuepress Theme Plume
config:
  -
    type: hero
    full: true
    effect: hyper-speed
    forceDark: true
    hero:
      name: Theme Plume
      tagline: VuePress Next Theme
      text: A simple, easy-to-use, feature-rich VuePress documentation & blog theme
      actions:
        -
          theme: brand
          text: Get Started →
          link: /en/guide/intro/
        -
          theme: alt
          text: Github
          link: https://github.com/pengzhanbo/vuepress-theme-plume
  -
    type: features
    features:
      -
        title: Responsive Layout
        icon: twemoji:laptop-computer
        details: Adapts to mobile devices, PCs, and tablets
      -
        title: Blog & Documentation
        icon: twemoji:open-book
        details: Whether you want to write a blog, product documentation, or both
      -
        title: Out-of-the-Box
        icon: twemoji:rocket
        details: Supports zero-configuration out-of-the-box, as well as rich customization options
      -
        title: Multi-language
        icon: twemoji:balance-scale
        details: Built-in support for 7 languages including Chinese and English, and you can customize and add more language support
      -
        title: Dual Color Theme
        icon: twemoji:cityscape
        details: Supports light/dark themes, including code highlighting
      -
        title: Plugins
        icon: twemoji:card-file-box
        details: Built-in rich plugins to meet general website needs
      -
        title: Search & Comments
        icon: twemoji:magnifying-glass-tilted-right
        details: Supports multiple comment systems, local search, and Algolia search
      -
        title: Encryption
        icon: twemoji:locked-with-key
        details: Supports full-site encryption and partial encryption (encrypted directories, encrypted articles)
      -
        title: Markdown Enhancement
        icon: twemoji:writing-hand-light-skin-tone
        details: Based on regular markdown syntax, adds dozens of enhanced syntaxes such as custom containers, file trees, code groups, etc.
  -
    type: image-text
    title: Features
    description: Built-in rich features to meet general website needs.
    image: /images/plume-1.svg
    list:
      -
        title: Article Information
        description: Add tags, categories, word count, reading time, writing date, and other information to articles.
      -
        title: Comments
        description: "Supports 4 comment systems: Giscus, Waline, Twikoo, Artalk<br>You can freely choose the comment system that suits your needs."
      -
        title: Search
        description: Supports local search based on minisearch, and also supports Algolia search.
      -
        title: Encryption
        description: Supports full-site encryption and partial encryption (encrypted directories, encrypted articles).
      -
        title: Code
        description: Code copying, CodePen demonstration, JSFiddle demonstration, CodeSandbox demonstration, code groups, line highlighting, line focusing, line warnings, difference comparison, code block folding, etc.
      -
        title: Resource Embedding
        description: "Charts: chart.js/ECharts/Mermaid/flowchart<br>Videos: Bilibili/Youtube/ArtPlayer<br>PDF, 200K+ Iconify icons"
  -
    type: text-image
    title: Blog
    description: The theme supports blogs by default, allowing you to create your personal blog.
    image: /images/plume-2.svg
    list:
      -
        title: Article List
        description: Automatically sorts and generates a blog article list page based on the article writing date.
      -
        title: Blogger Information
        description: Customize name, motto, avatar, and social media links.
      -
        title: Categories, Tags, Archives
        description: Automatically generates category pages, tag pages, and archives articles by year.
  -
    type: image-text
    title: Documentation
    image: /images/plume-3.svg
    description: The theme supports documentation by default, allowing you to create product documentation or organize your knowledge system.
    list:
      -
        title: Sidebar
        description: Automatically generates a sidebar based on the documentation directory, or you can manually configure it. The theme provides a simpler configuration method.
      -
        title: Documentation Classification
        description: You can categorize different documents into different directories for better management of the documentation structure.
  -
    type: custom
---

<div style="max-width: 960px;margin:0 auto;" class="home-custom-content">

::: center

![GitHub Repo stars](https://img.shields.io/github/stars/pengzhanbo/vuepress-theme-plume){.no-view}
![npm version](https://img.shields.io/npm/v/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=npm){.no-view}
![npm downloads](https://img.shields.io/npm/dm/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads){.no-view}
![npm downloads](https://img.shields.io/npm/dt/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads){.no-view}
![github license](https://img.shields.io/github/license/pengzhanbo/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A){.no-view}

![peer dependency](https://img.shields.io/npm/dependency-version/vuepress-theme-plume/peer/vuepress?color=32A9C3&labelColor=1B3C4A){.no-view}
![codecov](https://codecov.io/gh/pengzhanbo/vuepress-theme-plume/graph/badge.svg?token=W6KYBX7WO5){.no-view}

:::

### Usage

Use the following command to quickly create a new ==VuePress== project using this theme.

:::npm-to

```sh
npm create vuepress-theme-plume@latest
```

:::

### Start the project

::: npm-to

```sh
npm run docs:dev
```

:::

### Changelog

[Changelog](./changelog)

### Contributors

Thanks to all contributors!

<Contributors :contributors="data" />

</div>

<style>
.home-custom-content img {
  cursor: default !important;
}
</style>

<script setup>
import Contributors from '~/components/Contributors.vue'
import data from '@source/contributors.json'
</script>
