Jekyll vs MkDocs: What are the differences?
Jekyll: Blog-aware, static site generator in Ruby. Think of Jekyll as a file-based CMS, without all the complexity. Jekyll takes your content, renders Markdown and Liquid templates, and spits out a complete, static website ready to be served by Apache, Nginx or another web server. Jekyll is the engine behind GitHub Pages, which you can use to host sites right from your GitHub repositories; MkDocs: *A static site generator *. It builds completely static HTML sites that you can host on GitHub pages, Amazon S3, or anywhere else you choose. There's a stack of good looking themes available. The built-in dev-server allows you to preview your documentation as you're writing it. It will even auto-reload and refresh your browser whenever you save your changes.
Jekyll and MkDocs can be categorized as "Static Site Generators" tools.
Jekyll is an open source tool with 38.3K GitHub stars and 8.36K GitHub forks. Here's a link to Jekyll's open source repository on GitHub.
Sentry, New Relic, and Tilt are some of the popular companies that use Jekyll, whereas MkDocs is used by Hactar, elmah.io, and Worldsensing - Mobility. Jekyll has a broader approval, being mentioned in 148 company stacks & 628 developers stacks; compared to MkDocs, which is listed in 5 company stacks and 8 developer stacks.
What is Jekyll?
What is MkDocs?
Need advice about which tool to choose?Ask the StackShare community!
Why do developers choose MkDocs?
Sign up to add, upvote and see more prosMake informed product decisions
What are the cons of using MkDocs?
Sign up to get full access to all the companiesMake informed product decisions
What tools integrate with MkDocs?
Sign up to get full access to all the tool integrationsMake informed product decisions
With limited knowledge of CSS/HTML5, Jekyll makes it easy to create templates for static HTML5 sites. Unless I really need a database for something, this is the tool I prefer for standing up websites.
I settled on Jekyll to be the CMS for my research blog. Out of the box it works, and over time I added to it... why write a dissertation when you can instead hack templates to tweak things.
This static site generator is used with "contentful-import" ruby plugin, which allows to fetch data from Contentfull and generate new web-pages based on it. Easy and fun to use.
We wanted to pay the cost for website generation up front. Doing this allows us to put our website up in AWS S3 where it can be served reliably and for cheap.