Skip to content

Instantly share code, notes, and snippets.

@briandominick

briandominick/asciidoc-static.adoc

Last active April 21, 2026 00:06
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save briandominick/e5754cc8438dd9503d936ef65fffbb2d to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save briandominick/e5754cc8438dd9503d936ef65fffbb2d to your computer and use it in GitHub Desktop.
Download ZIP
Static Site Generators with AsciiDoc Support
Raw
asciidoc-static.adoc

These static site generators either natively support source files in AsciiDoc format or can be readily extended by an existing plugin. Not all generators have been evaluated; this is just a list of claims.

Application Adoc Support Source Lang Template Lang

Web Resources

AsciiBinder

native

Ruby

Tilt, ERB

* Official site

Jekyll

plugin

Ruby

Liquid

* Official site * jekyll-asciidoc plugin

Hugo

plugin

Go

Go libraries

AweStruct

native

Ruby

Haml

* Official site (down?) * GitHub project

Antora

native

Node.js

Handlebars

* Official site

Middleman

native*

Ruby

ERB, Haml

* Official site * middleman-asciidoc plugin (*for versions < 3.0)

Grain

native

Groovy

Groovy

Nanoc

native

Ruby

ERB

* Official site

Pelican

native*

Python

Jinja2

* Official site * (*Uses ‘legacy’ Python AsciiDoc)

Nikola

plugin

Python

Mako, Jinja2 * Official site

Metalsmith

plugin

JavaScript

Handlebars * Official site

JBake

native
@briandominick
Copy link
Copy Markdown
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
Copy link
Copy Markdown

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
Copy link
Copy Markdown

bbatsov commented Jun 13, 2019

There's also https://github.com/cryogen-project/cryogen

@briandominick
Copy link
Copy Markdown
Author

briandominick commented Jun 13, 2019

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

@kito99
Copy link
Copy Markdown

kito99 commented Sep 5, 2019

Are any of these good for blogs other than cryogen?

@Pingvin235
Copy link
Copy Markdown

Pingvin235 commented May 8, 2020

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

@korbendallaskoop
Copy link
Copy Markdown

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
Copy link
Copy Markdown

shomodj commented Jun 17, 2020

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

@ojn
Copy link
Copy Markdown

ojn commented Jan 20, 2021

This is a good one https://github.com/Dev-Mind/devmind-website
actually one of the best static site generators with asciidoc support (Asciidoctor.js) I found yet, the author is very humble and states "it is a Node module for Asciidoctor.js and Handlebars using Gulp". In my opinion it deserves to be a full fledged SSG with themes, plugins and everything.

@korbendallaskoop
Copy link
Copy Markdown

korbendallaskoop commented Mar 25, 2021

came across Hexo while checking the https://gitlab.com/pages SSGs

"....Hexo support posts written in any format, so long the corresponding renderer plugin is installed. It can be in markdown, ejs, swig, nunjucks, pug, asciidoc, etc. Regardless of the format used, those three code block syntax will always be available."

https://hexo.io/docs/syntax-highlight#How-to-use-code-block-in-posts

@hahaleyile
Copy link
Copy Markdown

hahaleyile commented Nov 16, 2021

Awesome!

@patrickdung
Copy link
Copy Markdown

patrickdung commented Jan 1, 2022

For Pelican plugin, by default, it supports legacy asciidoc and asciidoctor.
It would use asciidoc if it is installed.
If you want to use asciidoctor then just uninstall asciidoc and then install asciidoctor only.

https://github.com/getpelican/pelican-plugins/blob/master/asciidoc_reader/asciidoc_reader.py#L44

@ioannisstavrakakis
Copy link
Copy Markdown

ioannisstavrakakis commented Jun 1, 2022

Is there a mistake on Antora? Should the source language be JavaScript (based on https://jamstack.org/generators/antora/)?

@kurt-krueckeberg
Copy link
Copy Markdown

kurt-krueckeberg commented Jul 26, 2022

Very helpful. Thanks!

@childnode
Copy link
Copy Markdown

childnode commented Oct 19, 2022

JBake supports also pebble now https://jbake.org/docs/latest/#templates_directory

➕

Application AsciiDoc Support Source Lang Template Lang
docToolChain native Groovy arc42

is wrong in my eyes since

  • it is not native, it uses asciidoctor or other generators with asciidoc support
  • srcLang is java to me since it uses jbake, perhaps there are bash / powershell scripts around that ..
  • Template Lang is defined by jbake

➕

Application AsciiDoc Support Source Lang Template Lang
Hugo plugin

I don't see that there is an optional plugin but you have to just install the asciidoc command, then the converter can be called for .adoc ?! can't it?
^^ what is the definition of "native" and "plugin" here?

@brettaufheber
Copy link
Copy Markdown

brettaufheber commented Mar 14, 2023

Nice list, I would like to ask whether this app can be part of this list.

Application AsciiDoc Support Source Lang Template Lang Web Resources Notes
asciidoc-site-generator native (asciidoctor) JavaScript (Node.js) Handlebars Source GitHub A website generator with very small footprint.

@ahus1
Copy link
Copy Markdown

ahus1 commented Mar 22, 2023

The links for Shitty SSG seem broken to me. The new link might be https://codeberg.org/ewintr/shitty-ssg

@clawson
Copy link
Copy Markdown

clawson commented Jun 29, 2023 •
edited
Loading

The links for Shitty SSG seem broken to me. The new link might be https://codeberg.org/ewintr/shitty-ssg

That link is broken too. I found this one: https://ewintr.nl/shitty-ssg/

@atharvashukla
Copy link
Copy Markdown

atharvashukla commented Jul 11, 2023

Thank you! This is really helpful

@briandominick
Copy link
Copy Markdown
Author

briandominick commented Feb 29, 2024

I have just posted a major update to this matrix. I removed a couple of tools and added several. I also made lots of corrections to the info and formatting, as well as adding FOSS licenses for each. I intend to release the source code for the YAML I use to maintain all of this data, as well as the template I use to parse it into AsciIDoc, as soon as I can get the rest of its parent repo ready for public release. Happy to take comments, suggestions, additions, etc.

NOTE: I removed LiquiDoc and docToolChain because I believe they are more like frameworks than SSGs themselves. I am going to create/add a file for frameworks and other integrations at some point.

@Malix-Labs
Copy link
Copy Markdown

Malix-Labs commented Mar 9, 2024 •
edited
Loading

Next step (and a very important one) would be Astro

@osbyrne
Copy link
Copy Markdown

osbyrne commented Mar 9, 2024

Next step (and a very important one) would be Astro

I second this proposal

@lizhongyue248
Copy link
Copy Markdown

lizhongyue248 commented Mar 11, 2024

Next step (and a very important one) would be Astro

+1

@briandominick
Copy link
Copy Markdown
Author

briandominick commented Mar 11, 2024

Added Astro, by sudden popular demand.

@robb-romans
Copy link
Copy Markdown

robb-romans commented Mar 11, 2024

Added Astro, by sudden popular demand.

💯

@myrkvi
Copy link
Copy Markdown

myrkvi commented Jun 16, 2025

Added Astro, by sudden popular demand.

Astro plugin does not work for the latest major version of Astro (v5)

@ciampix
Copy link
Copy Markdown

ciampix commented Jan 4, 2026

Please add this: https://github.com/gabevenberg/ASCIISite

@Malix-Labs
Copy link
Copy Markdown

Malix-Labs commented Jan 5, 2026

https://github.com/gabevenberg/ASCIISite

0 stars, last activity 4 years ago

Hm…

@fpapon
Copy link
Copy Markdown

fpapon commented Feb 3, 2026

There is yupiik-minisite that is focused on asciidoc only and we also provided the asciidoc-java and ascii2svg modules.

@ojn
Copy link
Copy Markdown

ojn commented Mar 27, 2026

Hello!
I have updated dependencies for https://github.com/Dev-Mind/devmind-website/releases/tag/1.0.0
it's a fairly simple Gulp based static site generator based on Asciidoctor.js
I have no uses for it currently, so I'm planning to archive it since I'm not a JS programmer.

https://github.com/AsciiWriter/asciiwriter

It's meant as a base to make something that suits your own site.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment