GitHub repositories can render/preview asciidoc (.adoc) documents, apparently using asciidoctor.

But I can't seem to make pages served by GitHub Pages (GitHub's Jekyll-based service that serves repository documents under github.io) render my asciidoc documents.

Is it even possible?


1 Answer 1


Jekyll does support rendering AsciiDoc via a plugin, however this isn't part of the default GitHub Pages Jekyll setup.

GitHub lets you configure Jekyll plugins by adding them to the _config.yml file. However jekyll-asciidoc isn't on the list of supported plugins at this time.

You could try submitting a request to GitHub to add jekyll-asciidoc to the list of supported plugins, otherwise you'll have to run Jekyll yourself.


Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.