hexo

- 2 min. read

Create a simple Markdown-based blog (like this very one) without hosting and for free:

Prerequisites

Software prerequisites:

Other prerequisites:

  • A Github account

Steps

1) Install Hexo Framework

2) Setup the blog:

1
2
3
$ hexo init {blogname}
$ cd {blogname}
$ npm i

3) Find a cool theme for Hexo and clone it in your local themes folder:

1
$ git clone {theme-github-url} themes/{theme-name}

4) Check the docs of your theme, it may be you have to change some settings to match your liking:

1
2
$ cd themes/{theme-name}
$ vi _config.ym

5) Open the _config.ym file on the root of the blog (not the theme _config.ym)

1
2
$ cd ../..
$ vi _config.ym

6) change the line theme: to match your theme name:

1
theme: {theme-name}

7) Update blog info:

1
2
3
4
5
6
title: Coding tips 
subtitle:
description:
author: Tonino Catapano
language: en
timezone: Europe/Amsterdam

8) Create a new blog post:

1
$ hexo new post {your-blog-post-name}

9) Edit the Markdown file created under the source/_posts folder with you post content!

10) Go on Github and create a repo called {your_github_username}.github.io

11) Into the settings tab of the repo enable the Github pages functionality, eventually
settings up your custom domain, if you own any:

github pages example

12) Set up the blog folder to point at the newly created repo

1
2
3
$ git init
$ git SET REMOTE
$ git push