Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Metalsmith

By Metalsmith · metalsmith.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
7.8 Club score Visit metalsmith.io

What Metalsmith is

Metalsmith is a free static-site generator for NodeJS that works as a pluggable library rather than a framework requiring a set project layout. It turns a directory tree into plain JavaScript objects that plugins can change and build. Developers can shape project structure and output through plugins, and use either a JavaScript API or command-line interface. Metalsmith works with npm, Markdown, JSON, YAML and a chosen templating language, with configuration over code or code over configuration. Example uses include static sites, scaffolding, backups, command-line and deployment tools, as well as eBooks produced from Markdown for PDF, ePUB or MOBI. Starter repositories cover blog, company, resume and clean-blog projects. Builds produce static folders deployable to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts or custom servers. Plugin examples include Sass, PostCSS, JavaScript bundling, Markdown, collections and layouts. It requires NodeJS and lists API, Linux, macOS and Windows platforms. The supplied pages state no billing terms or prices, and the pricing page returns a 404. Partial rebuilds are not available; documentation recommends a file watcher and browser synchronization package for automatic rebuilds.

Who it suits

Metalsmith suits NodeJS developers who want to assemble a static-site build around plugins and their own project structure. It can also support other file-generation workflows such as eBooks and command-line tools.

Good to know, and what to watch

  • Provides both a JavaScript API and CLI.
  • Does not require a predefined project structure.
  • Supports Markdown, JSON and YAML.
  • Builds can be deployed to several hosting targets.
  • Requires NodeJS.
  • Partial rebuilds are not available.
  • Pricing page returns a 404.
  • No local preview server is listed.

Metalsmith.js

Free

Free plan

The verdict

Metalsmith offers a flexible, plugin-based approach to static output and other build tasks. Developers should account for the NodeJS requirement and lack of partial rebuilds when planning an automatic workflow.

What the maker publishes

API and CLI
The package exposes both a JavaScript API and a command-line interface. source
Billing information
No billing terms or prices are stated on the supplied pages. source
Build limitation
Metalsmith does not yet offer partial rebuilds; the documentation recommends using a file watcher and browser synchronization package for automatic rebuilds. source
CMS integration
Yes source
Community channel
The project says informal announcements are made periodically in the Gitter community chat. source
Company attribution
The site copyright notice attributes the website to webbketje and dates it 2021. source
Configuration modes
It supports both configuration over code and code over configuration. source
Content sources
markdown source
Core plugins
Plugins with the @metalsmith/ prefix are core plugins officially supported by Metalsmith. source
Current release
Metalsmith 2.7 requires NodeJS 16 or newer and adds metalsmith.yml configuration support plus init and clean CLI commands. source
Deployment
Builds are static folders that can be deployed to a CDN, Netlify, GitHub Pages, GitLab Pages, SFTP host or custom server over SSH. source
Deployment targets
Static folders can be deployed to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers. source
eBook formats
An example eBook workflow can produce PDF, ePUB, and MOBI files from Markdown. source
Founded
2014 source
Free plan
Yes source
Incremental builds
Yes source
File transformation
It translates a directory tree into plain JavaScript objects that plugins can manipulate. source
Integrations
Examples of plugin integrations include Sass, PostCSS, JavaScript bundling, Uglify, Markdown, collections and layouts. source
Interfaces
The package exposes both a JavaScript API and a CLI. source
Library design
Metalsmith works more like a library than a framework and does not require a predefined structure. source
Multilingual support
Yes source
Operating systems
Metalsmith builds are tested on Linux and Windows systems and officially supported NodeJS LTS releases. source
Package installers
Installation examples are provided for npm, yarn, and pnpm. source
Plugin architecture
Plugins provide control over how projects are conceptualized, structured, and built. source

Checked against the maker's pages on 28 Sept 2026.