Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A generic static site generator built using flatiron, plates, and marked.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


A static site generator built with Node.js, JSDOM, and Weld.

Blacksmith is a static site generator designed for simplicity and ease of use. Blacksmith will generate your content in seconds as a stand-alone static site ( comprised of HTML / CSS ) that can be hosted anywhere with no dependencies. Articles are edited as Markdown files, and themes are just plain HTML and CSS files (no inane microtemplates or strange markup languages).

Static sites are generated using Weld and JSDOM. Blacksmith also ships with a built in Node.js static file server, so Blacksmith can host itself, if you'd like.


  • Easy to use
  • Can be hosted anywhere, since it generates static HTML/CSS
  • Write and Edit articles on the file system using markdown
  • JSDOM / Weld based
  • Easily create custom themes using plain HTML and CSS ( no micro-templating ! )
  • Ships with a robust node.js static server suitable for production

Getting Blacksmith

git clone
cd blacksmith

One of blacksmith's dependencies is a bundle of site scaffolds, which is non-published. So:

mkdir node_modules
cd node_modules
git clone
cd ..

Now, link it up:

sudo npm link

This will link up the development version of blacksmith.


Now that you have cloned your own copy of Blacksmith, getting started is easy!

Generating a new static site

blacksmith generate

This command will generate a new version of your blog using source files from the ./pages folder and put the generated content into ./public/.

Serving your static site

Now simply drop ./public into any public HTTP server and your site is good to go!

If you need a HTTP server, just use Blacksmith's built-in Node.js HTTP server with:

blacksmith serve

This command will start up a static http server that will serve the contents of ./pages.

Want to learn more?

The documentation for blacksmith is hosted as a blacksmith site. You can access it by running 'blacksmith init' and choosing the "docs" site.

Author: Nodejitsu Inc.

Something went wrong with that request. Please try again.