Need advice about which tool to choose?Ask the StackShare community!

Jekyll

1.5K
1.3K
+ 1
231
MkDocs

77
115
+ 1
8
Add tool

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.

Decisions about Jekyll and MkDocs
Manuel Feller
Frontend Engineer at BI X · | 4 upvotes · 116.5K views

As a Frontend Developer I wanted something simple to generate static websites with technology I am familiar with. GatsbyJS was in the stack I am familiar with, does not need any other languages / package managers and allows quick content deployment in pure HTML or Markdown (what you prefer for a project). It also does not require you to understand a theming engine if you need a custom design.

See more
Get Advice from developers at your company using StackShare Enterprise. Sign up for StackShare Enterprise.
Learn More
Pros of Jekyll
Pros of MkDocs
  • 75
    Github pages integration
  • 54
    Open source
  • 37
    It's slick, customisable and hackerish
  • 24
    Easy to deploy
  • 23
    Straightforward cms for the hacker mindset
  • 7
    Gitlab pages integration
  • 5
    Best for blogging
  • 2
    Low maintenance
  • 2
    Easy to integrate localization
  • 1
    Huge plugins ecosystem
  • 1
    Authoring freedom and simplicity
  • 3
    Speed
  • 3
    Gitlab integration
  • 1
    Extensibility
  • 1
    Themes

Sign up to add or upvote prosMake informed product decisions

Cons of Jekyll
Cons of MkDocs
  • 4
    Build time increases exponentially as site grows
  • 2
    Lack of developments lately
  • 1
    Og doesn't work with postings dynamically
    Be the first to leave a con

    Sign up to add or upvote consMake informed product decisions

    - No public GitHub repository available -

    What is Jekyll?

    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.

    What is MkDocs?

    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.

    Need advice about which tool to choose?Ask the StackShare community!

    Jobs that mention Jekyll and MkDocs as a desired skillset
    CBRE
    United States of America Texas Dallas
    CBRE
    United Kingdom of Great Britain and Northern Ireland England Grays
    What companies use Jekyll?
    What companies use MkDocs?
    See which teams inside your own company are using Jekyll or MkDocs.
    Sign up for StackShare EnterpriseLearn More

    Sign up to get full access to all the companiesMake informed product decisions

    What tools integrate with Jekyll?
    What tools integrate with MkDocs?
      No integrations found

      Sign up to get full access to all the tool integrationsMake informed product decisions

      Blog Posts

      GitHubPythonSlack+25
      7
      2951
      What are some alternatives to Jekyll and MkDocs?
      WordPress
      The core software is built by hundreds of community volunteers, and when you’re ready for more there are thousands of plugins and themes available to transform your site into almost anything you can imagine. Over 60 million people have chosen WordPress to power the place on the web they call “home” — we’d love you to join the family.
      Hugo
      Hugo is a static site generator written in Go. It is optimized for speed, easy use and configurability. Hugo takes a directory with content and templates and renders them into a full html website. Hugo makes use of markdown files with front matter for meta data.
      Hexo
      Hexo is a fast, simple and powerful blog framework. It parses your posts with Markdown or other render engine and generates static files with the beautiful theme. All of these just take seconds.
      Ghost
      Ghost is a platform dedicated to one thing: Publishing. It's beautifully designed, completely customisable and completely Open Source. Ghost allows you to write and publish your own blog, giving you the tools to make it easy and even fun to do.
      Sphinx
      It lets you either batch index and search data stored in an SQL database, NoSQL storage, or just files quickly and easily — or index and search data on the fly, working with it pretty much as with a database server.
      See all alternatives