Skip to main content

Theme intro

About 3 minGet StartedGet StartedIntro

Original Intention

VuePress extends Markdown syntax to a certain extent, but it still lacks some commonly used functions, such as text alignment, mark, flowchart, formula, presentation, etc. At the same time, some features provided by the default theme are weak or missing, such as picture preview, code block copy, toc, etc. Meanwhile, VuePress default theme is too simple and not powerful enough. vuepress-theme-hope and related plugins were born under this situation.

We not only greatly improve outlook comparing to default theme, but also provide a full range of enhancements for VuePress with theme plugins.

Design Goals

Powerful and independent features

We extract each feature into a plugin, so that users can use them in other themes or customize their behavior standalone.

Minimum Configuration

All features will try to use a default value if possible, so you can use them under zero or minimum configuration.

This helps a lot to reduce your migration or learning costs while directly enjoy their convenience.

Improved Layout

The theme interface has been completely refactored to provide customizable and beautiful layouts.


With the help of Vue3's composition API, the theme fully achieve "Tree-shaking" while remaining powerful.

The theme will only run with features you want, without being slowed down by other features or affecting the bundle size.

Why Powerful

Content Richness

The theme provides a lot of extended syntax support for Markdown, allowing you to insert more content in the body.

In short, anyone can enjoy the convenience of Markdown's enhanced syntax.

UI Improvements

Layouts Improvement

Page Meta

New Features

Blog Support

The theme supports blogging, with article list with sticky support, starred articles, auto excerpt generation, auto summary.

Build-in Plugins🧩

The theme includes the following plugins, you can use them in other themes or directly.


Here are some other plugins that are not bundled by the theme, you can enable them according to your own needs.