Building a Static Site Generator with Pandoc and Bash

Here’s how to build your own JAMStack static site generator with nothing more than Pandoc and Bash.

💎 Forget about all the other SSG engines out there. Why be constrained to their bad and inflexible designs when you can make your own in a weekend and maintain full control — forever. Ours will even have a built in link validator to make sure you never have a broken link on your site, ever (well at least none you don’t know about). None of the existing SSGs have anything like that.

TODO for now you can look at https://gitlab.com/skilstak/kn3/sk to get an idea of what this entails.

“Can’t I just use Muffet without making my own SSG?”

Yes, but chances are it will be much slower.

Having a locally rendered version of your site that muffet can check is so much faster than doing the same over the Internet that it is rather ridiculous not to setup your workflow to do your rendering and checking long before sending it up to the Internet.

Besides, you want to capture all those broken links before to push it into production.

Most of the SSG tools out there do have some method of local rendering, but many people use the rendering and building tools of the hosting provider (Netlify or GitLab or GitHub) instead forcing link checking into the step after pushing, which makes very little sense and is horribly inefficient.