Skip to content

Instantly share code, notes, and snippets.

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

There are 19 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

Gatsby

plugin

React JS

JSX

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

robb-romans commented Aug 9, 2018

Nice.

@benelog

This comment has been minimized.

Copy link

benelog commented Apr 12, 2019

Jbake also supports AsciiDoc.

@schauder

This comment has been minimized.

Copy link

schauder 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

briandominick commented Apr 25, 2019

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

@benelog

This comment has been minimized.

Copy link

benelog 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

briandominick 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

briandominick 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

mojavelinux 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

bbatsov commented Jun 13, 2019

@briandominick

This comment has been minimized.

Copy link
Owner Author

briandominick commented Jun 13, 2019

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

@kito99

This comment has been minimized.

Copy link

kito99 commented Sep 5, 2019

Are any of these good for blogs other than cryogen?

@Pingvin235

This comment has been minimized.

Copy link

Pingvin235 commented May 8, 2020

pzdcdoc.org - it is not exactly site, but more documentation book. Extended AsciiDoctor, written on Java.

@korbendallaskoop

This comment has been minimized.

Copy link

korbendallaskoop commented May 30, 2020

Awesome list, thanks Brian
Grain seems to be stale if not defunct, groovy no more
https://github.com/sysgears/grain/issues
https://github.com/sysgears/grain/graphs/code-frequency

@shomodj

This comment has been minimized.

Copy link

shomodj commented Jun 17, 2020

https://github.com/gollum/gollum#markups is a wiki with optional asciidoc support

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.