A gem that adds slim-lang support to Jekyll.
Clone or download
Pull request Compare This branch is 33 commits ahead of sunnyrjuneja:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib fix require Aug 5, 2014
.gitignore Initial commit Apr 7, 2013
.rspec Version bump to 0.8.0 Apr 13, 2013
.travis.yml Add Travis image badge Apr 13, 2013
Gemfile Initial commit Apr 7, 2013
History.md v0.10.0 Oct 9, 2014
LICENSE.txt v0.10.0 Oct 9, 2014
README.md update readme Oct 10, 2014
jekyll-slim.gemspec v0.10.0 Oct 9, 2014



Gem Version Dependency Status Code Climate Build Status

A gem that adds slim-lang support to Jekyll. Works for for pages, includes and layouts.


Add this line to your Gemfile:

gem 'jekyll-slim'
gem 'slim', github: 'slim-template/slim'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jekyll-slim

In your Jekyll project's _plugins directory:

# _plugins/jekyll-slim.rb
require 'jekyll-slim'


This gem requires slim from the github master branch for now.


The gem will convert all the .slim files in your project's directory into HTML. That includes files in sub-directories, includes and layouts. Example:

# _layouts/default.slim
    .content-wrapper {{ content }}

To include a partial, use the slim liquid tag instead of include:

# index.slim
layout: default

section.content Content goes here.
% include footer.slim


Is possible to set options available for Slim engine through the slim key in _config.yml. Example:

# _config.yml
  pretty: true
  format: html5


The slim context is set to acess a SlimContext object which has a site method, used to access config. Be careful because this is a breaking change.

This allows you to access configuration information in your slim file. Example:

      = "slim pretty mode: #{ site.config['slim']['pretty'].to_s }"

The SlimContext object will be kept across calls, allowing you to easily set @instance_variables that can be accessed by all slim files even those included with the slim liquid tag. Those are more or less global variables in slim templates, so be careful when you use them.

Looking for maintainers

We are looking for maintainers for this gem.


Jekyll-slim was heavily inspired by jekyll-haml. It is free software, and may be redistributed under the terms specified in the LICENSE file.