Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Middleman Guides

Reviewed by Hound

These are the source files that power the Middleman website, which is itself a Middleman-powered static page.

The guides are the primary documentation for Middleman, explaining the core features and extensions as well as pointing out community extensions.

Middleman is ever-vigilant against tag-soup, unreadable CSS and repetition. It stands-watch over your Haml, Sass, and CoffeeScript producing only the cleanest and most efficient markup.

How to run the site locally

Make sure you have Ruby 1.9.3+, Bundler and npm installed.

  1. Set up your machine:

  2. Start the server:

    bundle exec middleman server
  3. Open http://localhost:4567.

Mailing List

If you have questions, answers can be found on our community forum.


Please help Middleman flesh out its documentation. We'll merge in any reasonable extensions to our website docs, and give credit for your help!

The guides are written in Markdown.


Please, help support the Middleman team with a donation.

Copyright (c) Thomas Reynolds. Creative Commons Attribution 3.0 Unported License.