middleman

Create new project

$ middleman init [project_name]

$ middleman server

$ middleman server --port [4567]

$ middleman build

$ middleman build --clean

$ middleman article "[Article Title]"

$ middleman version

middleman [init] [server] [build] [article] [options]

Middleman is a static site generator built with Ruby. It uses templates, layouts, and data files to produce static HTML, CSS, and JavaScript.
The development server provides live reloading. Changes to source files automatically refresh the browser. This speeds up the design and development workflow.
Templates support ERB, Haml, Slim, and other Ruby templating languages. Asset pipeline handles Sass, CoffeeScript, and JavaScript bundling.
Data files in YAML or JSON populate templates dynamically. This separates content from presentation, enabling data-driven pages.
The blog extension adds post creation, tagging, and pagination. Articles are written in Markdown with YAML frontmatter.
Build produces a static site in the build directory, ready for deployment to any web server or CDN.

init NAME

Create new project.

Start development server.

Build static site.

Create new blog article.

Start interactive console.

Server port (default 4567).

Server bind address.

Remove orphaned files during build.

Verbose output.

Build environment (development, production).

Show help.

Requires Ruby environment. Plugin dependencies can be complex. Build times increase with site size. Some plugins may conflict.

Middleman was created by Thomas Reynolds starting around 2009. It brought modern web development practices (asset pipeline, live reload) to static site generation. The project influenced later static site generators.

jekyll(1), hugo(1), gatsby(1), bundle(1)