Minimal Mistakes

Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your personal site, blog, or portfolio on GitHub or your own server.

Source on GitHub Live demo

Minimal Mistakes splash layout.

Splash layout, ideal for landing pages.

Minimal Mistakes posts by year archive layout.

Group posts by year with this archive layout.

Minimal Mistakes post layout.

A post layout with optional author sidebar and customizable social media links, share buttons, and related posts widget.

Minimal Mistakes post layout with sidebars

Flexible and customizable. Easily add custom navigation and table of contents sidebars to documentation heavy pages.

Features

Includes responsive layouts (single, archive index, search, splash, and paginated home page) that look great on mobile and desktop browsers. As the name implies — styling is purposely minimalistic to be enhanced and customized by you.

GitHub Pages compatibility

Installs as a remote theme for an easier upgrade path. You can also install it as a Ruby gem or fork the repository and use it as a starter template.

Native Sass support

Leverages Jekyll’s built-in Sass/SCSS preprocessor for easier maintenance and customization of the theme’s colors and typography.

Color variations

Comes bundled with nine different “skins”.

Air skinContrast skinDark skin
air skincontrast skindark skin
Dirt skinMint skinSunrise skin
dirt skinmint skinsunrise skin
Aqua skinNeon skinPlum skin
aqua skinneon skinplum skin

Commenting

Includes support for the following commenting systems and providers: Disqus, Facebook, Discourse, static-based via Staticman, utterances, and giscus.

Localized user-interface

Includes translated text for all UI used across the theme in a YAML data file. Custom the text for any of the following languages (or add your own): English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Catalan, Chinese, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), and Vietnamese.

Documentation

To learn more about how to customize this theme, include feature images in posts, modify the look and feel, and create new posts, read up here. Includes sample pages showing off all layouts, components, and more.

Troubleshooting

Need help setting up the theme or getting it configured? Search the discussions or issues on GitHub. Having trouble installing or using Jekyll, the Jekyll Talk forum is a good place to ask for help.

License

This theme is free and open source software, distributed under the MIT License.

Related

HPSTR

Jekyll blog theme designed to give your site a tumble-log look.

So Simple

A simple Jekyll theme for words and pictures.