Tattoo Tuba
A New Blog

404 Page in Hexo for GitHub Pages

Provide an error page automatically when resource not found

As this blog is a static one, generated by Hexo and hostet at GitHub, the page which was shown, when a user enters an Url which points to nowhere, was the default GitHub 404 page.

GitHub 404 Page

Not optimal and should be solved by an own Hexo page, because GitHub Pages allows you to deliver a custom 404 page by creating simply a 404.html in the root of the website.

As you can create separate pages in Hexo, this is done quickly by:

hexo new page "404"

It generates a new folder named 404 in your source folder, where a is placed. In this file you can enter the text as Markdown you want to show to the user, in case of a 404 error (page not found) occurs.

On generating the static files by hexo generate, a subfolder 404 with a index.html will be created, which doesn’t really work with GitHub Pages, because it needs a 404.htm in the root.

You can fix this, by defining the permalink in the Frontmatter of your page:

title: 404
permalink: /404.html

Example … click here:

You can interact with this article (applause, criticism, whatever) by mention it in one of your posts, which will be shown here as a Webmention.

In case your blog software can't send Webmentions, you can use this form or send it manually via or Telegraph:


No Webmentions yet...