---

⭐️ If you like HexoPress, please star us and help more people discover it!

---

• HexoPress
  • Quick Start
  • I. Introduction
    • Tech Stack
  • II. Installation
    • 0. Compatibility
    • 1. Mac
    • 2. Windows
  • III. Features
  • IV. User Guides
  • V. Screenshots
    • 1. Dashboard
    • 2. Posts List
    • 3. Editor
    • 4. Categories Management
    • 5. Tags Management
  • VI. Getting Started from Source Code
    • 1. Clone the source code
    • 2. Running Environment
    • 3. Install Dependencies
    • 4. Run
    • 5. Package
  • VII. Contribution
    • 1. Report Issues
    • 2. Contribute Code
  • VIII. Join the Community
  • IX. Appendix

Quick Start

1. Download the version for your OS
2. Unzip and run HexoPress
3. Select your Hexo blog directory and start writing!

---

I. Introduction

HexoPress makes Hexo blogging as easy as WordPress! No more manual Front Matter editing — what you see is what you get, with multi-platform support and a desktop-level experience.

• Pain Point: Hexo’s native content management is scattered and complex, with metadata requiring manual editing.
• Solution: HexoPress reads Hexo’s cache in real time, displays categories/tags in a tree, and lets you set metadata with a click. Front Matter is auto-organized.
• Core Value: Minimal operation, WYSIWYG, Vim mode support, and a true desktop experience.

Tech Stack

• Vue 3, Element Plus, Vite 5, Electron, Fastify

---

II. Installation

0. Compatibility

• Supports Hexo 7.0.0 and above (uses Hexo 7.1.1 API internally)
• Please back up your blog directory before use (git integration recommended)

1. Mac

• Download for Apple Silicon: v1.2.0
• Download for Intel Chip: v1.2.0

2. Windows

• Download for Windows: v1.2.0

---

III. Features

• 📝 Article list with “Published”/“Draft” filter
• 📅 Filter by month
• 🗂️ Filter by category
• 🔍 Keyword search
• 🌳 Tree view for categories with article count
• 🏷️ Tag list with article count
• 🖼️ Media resource management
• ✍️ Markdown editor with preview
• 📋 Outline panel
• ⌨️ Vim key bindings
• 📊 Dropdown for categories/tags
• 🔖 Batch edit categories/tags (coming soon)
• ⚙️ Quick FrontMatter editing

---

IV. User Guides

• How to build a blog with Hexo?

---

V. Screenshots

Each screenshot is briefly explained below

1. Dashboard

Overview of your blog data

2. Posts List

Quickly filter and manage all posts

3. Editor

WYSIWYG, Vim mode supported

4. Categories Management

Tree structure for intuitive category management

5. Tags Management

Clear tag overview and statistics

---

VI. Getting Started from Source Code

1. Clone the source code

git clone https://github.com/charlestang/HexoPress.git

2. Running Environment

• Node.js >= v20.8.1
• npm >= v10.5.5
• Ports: 5173 (frontend), 2357 (local image service)

3. Install Dependencies

npm install

4. Run

npm run dev      # Start dev environment
npm run lint     # Lint code
npm run format   # Format code
npm run test     # Run tests

5. Package

npm run package
npm run make

---

VII. Contribution

1. Report Issues

• Submit an Issue

2. Contribute Code

1. Fork this repository
2. Create your feature branch: git checkout -b <feature-name>
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin <feature-name>
5. Submit a pull request

---

VIII. Join the Community

• WeChat/QQ/Telegram (add if available)

---

IX. Appendix

• Why I built HexoPress

---

⭐️ If you like HexoPress, please star us and help more people discover it!

---