Welcome to the Hexo’s documentation. This documentation will help you get started fast. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub or Google Group.

What’s Hexo?

Hexo is a fast, simple and powerful blog framework. It parses your posts with Markdown (or other render engines) and generates static files with a beautiful theme in seconds.


It only takes few minutes for you to get Hexo ready. If you encounter any problems on installation and you can’t find the solution here, please submit an issue and I’ll try to solve your problems.


Installing Hexo is quite easy. However, there are some things required before you get started:

If your computer already has the requirements above, congratulations! Just install Hexo with npm.

$ npm install -g hexo-cli

If not, please follow the following instructions to install all the requirements.

For Mac users

You may encounter some problems when compiling. Please install Xcode from App Store first. After Xcode is installed, open Xcode and go to Preferences -> Download -> Command Line Tools -> Install to install command line tools.

Install Git

  • Windows: Download & install msysgit.
  • Mac: Install it with Homebrew, MacPorts or installer.
  • Linux (Ubuntu, Debian): sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core

Install Node.js

The best way to install Node.js is installing with nvm.


$ curl | sh


$ wget -qO- | sh

Once installed, restart the terminal and run the following command to install Node.js.

$ nvm install 0.12

Or you can download the installer and install it.

Install Hexo

Once all the requirements are installed, you can install Hexo with npm.

$ npm install -g hexo-cli