Blogging for Developers With Hexo

Using a Static Site Generators like Hexo gives a developer a very fast blogging workflow, using familiar tools and giving the ability to write offline. Content is written in markdown, keeping it portable between any blog generators and making it easy to version in Git. You can also use Git to deploy your site quickly, even over slow networks.

Static sites can be hosted anywhere and are fast to serve and easy to cache. For example, Github Pages offers a very fast way to host your site.

Lets take a look at Hexo, my favourite static site generator.

Blogging with Hexo

Hexo has a very simple workflow. First you create a blog website:

hexo init

This gives you a new Hexo website with a responsive design theme, a working blog and a sample article.

Then simply create new posts with the command

hexo new "blog post title"

This creates a new file under sources/_posts/ Edit this file and write your blog in markdown.

You can view your blog at any time via a local hexo server.

hexo serve

As you save the blog posts you are writing you can see the changes via this local server, so you know what the site looks like before you deploy your posts.

Deploying your blog & posts

As Hexo creates a set of HTML, JavaScript & CSS files for your blog can deploy it on any web server.

I use Github Pages to host my blog as its incredibly fast and easy to use. Using a repository called on my jr0cket account, Github Pages serves up the content at [] from the master branch. Hexo is configured to deploy to this repository.

Read my getting started with Hexo article to create your first Hexo website and start writing blogs

Customising your posts

Each post is created from a template, which you can also customise in scaffolds/ or create new templates in scafolds.

Here is an example template I created when writing blog posts about hexo. It sets the category and tags as well as the topic image. I create a new blog post with hexo new hexo "blog post title":

title: {{ title }}
date: {{ date }}
categories: blogging
- hexo
{ img img-thumbnail /images/hexo-logo.png }

Thank you.

Customising themes

Landscape is the default Hexo theme and was created with responsive design principles, so it works well on all devices. You can also use one of the many Hexo themes or create your own theme.

See how I created my own version of the Hexo Landscape theme.

Using Git for content & git submodules for themes

As the markdown you write is text-based then its easy to use Git to manage versions of your content effectively. Git can also be used to manage any theme you create.

I created my own theme and rather than keep it in the same repository, I used Git submodules to manage theme and content changes seperately.

Read in more detail how I used Git Submodules for managing content seperately from a custom theme.

Why not just use blogging platforms

There are a large number of blogging platforms (wordpress, blogger, etc) that initially seem quick and simple to use. However, you soon discover their limitations and how slow they can be. If you want to customise themes then it becomes challenging or event impossible due to restrictions.

These services require you to create your content online which depends on you having a fast internet connection as you write. Most platforms were built several years ago, so are not always the most efficient and as they are typically database driven you end up with lots of round trip requests. So these platforms are not great if you are traveling into work, on your way to an event or at a conference where the WiFi is not great.

There are also proprietary plugins with some of these services that tie you into them and it is not always easy to migrate to another service.

Thank you.

This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License, including custom images & stylesheets. Permissions beyond the scope of this license may be available at @jr0cket
Creative Commons License