Jekyll Faces

Use Jekyll for your next site.
We'll hyde the scary parts.

Jekyll is a great blogging platform, but to make it really shine, you need to make some tweaks. We’ve made those tweaks, and we’ve done so in such a way as to avoid using plugins, so your site can easily be hosted on GitHub Pages.

404 Pages

Do you hate boring 404 pages? We do too! Jekyll Faces provides several built-in pages, or you can use those examples as a template to create your own.


If you want to collect and analyze insights about your visitors and how they use your site, enable analytics. Several vendors are supported. See which posts attract more traffic. Improve engagement. Target content.


Based on Jekyll, Jekyll Faces provides blogging support via static HTML. No database, no server, no comment moderation. You get all the features of the bloated platforms, without any of the headaches.

Writing Books

If you’re thinking about writing a book (or several), it’s hard to beat markdown for writing your draft. Create a folder for your book, include a summary.md file and a cover.png file, then start writing chapters as separate markdown files. Jekyll Faces tracks your progress, updating word counts as you edit.


Even though Jekyll builds static sites, that doesn’t mean that you can’t have dynamic features like comments. Jekyll Faces supports several vendors, including Facebook and Disqus.


Do you work well with others? Jekyll Faces makes it easy to share the spotlight. List one, or one hundred, authors. Each gets their own markdown file with a bio.


So, you have a shiny, new open-source project and you want to tell the world about it? Good documentation is a key component to increase adoption and help others understand the guiding design decisions. Jekyll Faces makes organizing your documentation easy.

Font Icons

Jekyll Faces provides out-of-the-box support for a variety of web-based icon fonts, including Font Awesome, Glyphicons, and Foundation. We use GlyphSearch to identify the icons we would like to include, then add those glyphs to our pages.

GitHub Pages

Jekyll Faces adds functionality to Jekyll in a generic way so that your site can easily be hosted for free on GitHub Pages. We don’t use plugins or custom code. Everything is implemented in plan, old Liquid templates and JavaScript.


Jekyll is a great tool to organize and present your blog, but it’s missing a key feature. If you want add search capabilities, you’re on your own. Jekyll Faces uses JavaScript and Liquid templates to implement a plugin-free, GitHub-Pages-friendly method for visitors to search your content.

Web Apps

If you’re building a static, client-side web application, we’ve got you covered. You’re busy building your app, don’t waste time adding features like blog posts, news items, and documentation scaffolding. Jekyll Faces makes it easy to add one or more web apps to your site.


What most projects implement as custom plugins that don’t work with GitHub Pages, Jekyll Faces uses Liquid templates, and a touch of JavaScript, to add missing features.