Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Static Site Generators with AsciiDoc Support

There are 18 static site generators that support AsciiDoc sourcing.

Application AsciiDoc Support Source Lang Template Lang Web Resources Notes

AsciiBinder

native

Ruby

Tilt, ERB

  • Maintainers now recommend Antora!

Antora

native

Node.js

Handlebars

  • Maintained by lead contributors to the Asciidoctor project.

AweStruct

native

Ruby

Haml

Cryogen

native

Clojure

Selmer

DocPad

plugin

Coffeescript

Eco, Jade, Haml

docToolChain

native

Groovy

arc42

  • For documenting software architectures

Grain

native

Groovy

Groovy

Hugo

plugin

Go

Go

JBake

native

Java

Freemarker, Groovy, Thymeleaf, Jade

Jekyll

plugin

Ruby

Liquid

  • Most-popular SSG of all

  • Plugin maintined by Asciidoctor.

LiquiDoc

native

Ruby

Liquid

  • Uses Jekyll and Asciidoctor to generate sites, PDFs.

Metalsmith

plugin

JavaScript

Handlebars

Middleman

native

Ruby

ERB, Haml

  • Plugin maintined by Asciidoctor.

Nanoc

native

Ruby

ERB

Nikola

plugin

Python

Mako, Jinja2

Orchid

plugin

Java

Pebble

Pelican

native*

Python

Jinja2

(* Uses legacy AsciiDoc for conversion)

Spring REST Docs

native

Gradle

Mustache

@robb-romans

This comment has been minimized.

Copy link

commented Aug 9, 2018

Nice.

@benelog

This comment has been minimized.

Copy link

commented Apr 12, 2019

Jbake also supports AsciiDoc.

@schauder

This comment has been minimized.

Copy link

commented Apr 16, 2019

The link for jekyll is wrong, it should be https://jekyllrb.com/

@briandominick

This comment has been minimized.

Copy link
Owner Author

commented Apr 25, 2019

Thanks @schauder, and what an awesome entry, @benelog. Updated and alphabetized.

@benelog

This comment has been minimized.

Copy link

commented May 4, 2019

Thank you for the update.
I found one more, Orchid supports AsciiDoc.

@briandominick

This comment has been minimized.

Copy link
Owner Author

commented May 17, 2019

I am working on a way to source this in YAML and convert with AsciiDoc. The tooling is not quite ready, but I found some new SSGs and wanted to get them added before Write the Docs Portland, so we can show off the growth and reach of AsciiDoc! So I used the tool to generate this and will eventually automate publishing this Gist on update. I'll be releasing it all shortly.

@briandominick

This comment has been minimized.

Copy link
Owner Author

commented May 17, 2019

I just added GitBook but immediately removed it when someone noted that the currently supported version does not support AsciiDoc. Bummer.

@mojavelinux

This comment has been minimized.

Copy link

commented May 26, 2019

Awestruct is now defunct (despite the fact that it's still used for asciidoctor.org).

The Middleman plugin is also maintained by Asciidoctor atm.

@bbatsov

This comment has been minimized.

Copy link

commented Jun 13, 2019

@briandominick

This comment has been minimized.

Copy link
Owner Author

commented Jun 13, 2019

Very cool @bbatsov -- I've added it. First Clojure and Selmer entries!

@kito99

This comment has been minimized.

Copy link

commented Sep 5, 2019

Are any of these good for blogs other than cryogen?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.