Home

To help you to get started with metalsmith templating, we've created a collection of examples that demonstrate common use-cases. Feel free to contribute new examples or update existing ones. To help newcomers, please keep the examples as simple and clear as possible, and try to stick to the existing style. If anything is unclear, feel free to let us know in our slack channel so we can improve it!

Examples

Basic example with markdown

A lot of people prefer to write their content in markdown instead of directly in html. This example shows you how to use metalsmith-in-place to transform markdown to html.

Using Metalsmith-in-place and Metalsmith-layouts with Nunjucks

Using Metalsmith-in-place with Nunjucks

Using markdown posts with a nunjucks template

A common way of building a blog with metalsmith would be to use metalsmith-in-place to render your markdown source files to html, and then to use metalsmith-layouts to wrap the result in a common base template. (explain difference a bit: It is common to use both metalsmith-layouts and metalsmith-in-place to generate a static site with metalsmith. Simply put, metalsmith-layouts is a easy way to wrap your source files in a template. The other plugin, metalsmith-in-place, just renders the content in your source files.)