Notes on Metalsmith and Jekyll

I love the concept of building project documentation websites out of simple Markdown and Mustache files. Recently I used Metalsmith (with Node.js) for creating the un-official Latvian eID documentation site and more recently Jekyll for the WP Shuttle project. In this post I want to note and compare these tools.

Instructions for building a documentation website with Jekyll



Continuous Deployment

Unfortunately GitHub pages don’t support HTTPS for sites with custom domains so I discovered Netlify which provides free continuous deployment and hosting with custom domains and TLS from Let’s Encrypt. Their dashboard is also very nice!

Overall, both Metalsmith and Jekyll are awesome tools, and paired with continuous deployment can reduce the effort required for maintaining a project website.

Leave a Reply