Software Alternatives & Reviews

Asciidoctor Reviews

In the spirit of free software, everyone is encouraged to help improve this project.

Latest User Reviews

  1. User avatar
    Professional output from open source

    If you are looking for an open documentation solution ny which you can implement single sourcing while integrating with a complex build process then this is a great solution.

    👍 Pros:    Easy integration|Easy to use

Post a review

Social recommendations and mentions

We have tracked the following product recommendations or mentions on Reddit and HackerNews. They can help you see what people think about Asciidoctor and what they use it for.
  • I wish Asciidoc was more popular
    In fact, also this claim is wrong, because there are three :D 1. - Source: Hacker News / about 2 months ago
  • Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
    Asciidoctor is a Ruby-based text processor for parsing AsciiDoc into a document model and converting it to HTML5, PDF, EPUB3, and other formats. Built-in converters for HTML5, DocBook5, and man pages are available in Asciidoctor. Asciidoctor has an out-of-the-box default stylesheet and built-in integrations for MathJax (display beautiful math in your browser), highlight.js, Rouge, and Pygments (syntax... - Source: / 2 months ago
  • Docs as code vs a tool that can work with .md and xml?
    If you're looking at AsciiDoc, you'll want to look at Asciidoctor: - Source: Reddit / 4 months ago
  • Mau: a lightweight markup language based on Jinja
    The third system that I found was AsciiDoc, which started as a Python project, abandoned for a while and eventually resurrected by Dan Allen with Asciidoctor. AsciiDoc has a lot of features and I consider it superior to Markdown, but Asciidoctor is a Ruby program, and this made it difficult for me to use it. In addition, the standard output of Asciidoctor is a nice single HTML page but again customising it is a... - Source: / 7 months ago
  • What's your documentation stack?
    We use Antora and Asciidoc, published as in Gitlab pages, for technical documentation. - Source: Reddit / 10 months ago
  • Stunning Presentations with Asciidoctor and RevealJS
    In the previous post, we quickly saw the power of Asciidoctor, how it could enhance the documentation, writing and many other features. - Source: / 10 months ago
  • Running Jekyll on a Mac
    At this stage, a standard Jekyll blog should work. Yet, my blog also uses Asciidoctor, and more importantly, asciidoctor-diagram. I draw my diagrams using the PlantUML syntax. PlantUML requires a JVM and graphviz. - Source: / 10 months ago
  • Asciidoctor - A Writer's Swiss Army Knife
    The toolchain that brings power of Asciidoc is Asciidoctor. It parses Asciidoc files and helps in converting them to various formats - HTML5, PDF, DocBook, ePub, man pages etc. - Source: / 10 months ago
  • Does something like git for MS Word Exisits?
    I looked at this for a similar problem. Pandoc is a beast. I eventually used it alongside which was a pretty tight tool chain for an extended markdown format to see - Source: Reddit / 11 months ago
  • Parsers that don't yet exist?
    In this space, I'd love to see more asciidoctor (, they are in the process of writing up the spec at - Source: Reddit / about 1 year ago
  • DocBook 5.1: The Definitive Guide (2020)
    I've the same experience. Soem years ago I tried DocBook to render HTML and PDF documents, but the whole setup was so unpleasant that I gave up. Writing the syntax is not overly hard, but also not pleasant. I ended up with AsciiDoc, what is nice to read and write and which has a rich set of features. It is also very easy to set up: just download AsciiDoctor and you're ready to go. - Source: Hacker News / about 1 year ago
  • Thoughts on Markdown
    I'm wondering that the article doesn't mention AsciiDoc with a single word. AsciiDoc is a perfect tool for complex text documents with tables, references, side notes etc. It is almost as easy as Markdown (if you compare only the features included in both), but offers way more possibilities. There are also good tools to convert it to different output formats like HTML and PDF. A good starting point is:... - Source: Hacker News / about 1 year ago
  • What text editor do you use for rough drafts?
    Did you checkout the asciidoc format? It’s close to what you are doing but with way more options (table of content, tables, indexes, glossaries, sidebars, internal links, etc). It got you covered for lots of stuff. - Source: Reddit / about 1 year ago
  • Merry Christmas! I am giving away my ebook Command Line: A Modern Introduction for free. Grab your copy as a gift :)
    This is done with and their asciidoc-pdf tool. - Source: Reddit / over 1 year ago
  • My failed attempt to use groff output.
    Does it have to be pandoc? What about using asciidoc for the syntax? Then you could use asciidoctor for html output and asciidoctor-pdf for the pdf output. - Source: Reddit / over 1 year ago
  • Plugins in Rust: Diving into Dynamic Loading |
    I'm using Hugo with the theme PaperMod. You can take a look at the source code of the site here, it's pretty easy to get started if you look up a guide online. Also, I use Asciidoc instead of Markdown because it has more features built-in (customization, references, variables, etc). - Source: Reddit / over 1 year ago
  • AsciiDoc is the better Markdown
    So I was sold. I started learning how to use AsciiDoc to write my eBook and how to use AsciiDoctor to process my source file and produce many output formats like PDF, ePub or HTML from it very easily. - Source: / over 1 year ago
  • Tools for Embedded Development and Your Routines as Firmware Engineer
    Asciidoc ( or markdown, RST etc for documentation. - Source: Reddit / over 1 year ago
  • Technical documentation that just works
    For more complex technical documentation AsciiDoc would be a better fit than markdown. A simple table with code blocks is not possible with markdown, for example. I think the target audience is pretty much the same as for AsciiDoctor. - Source: Hacker News / almost 2 years ago
  • On semantic markup language design, and how I ended up rolling my own
    Capable of semantic markup: like HTML/CSS, LaTeX or Asciidoc. That is, a language semantically Extensible enough so that true WYSIWYM can happen, allowing for a Better time at maintenance and refactorings in big projects. So no markdown And similarly semantically limited languages, which are a bit like text-based Attempts at WYSIWYG), if that is a Thing. - Source: Reddit / almost 2 years ago
  • Markdown, DocBook, and the quest for semantic documentation on
    They shouldn't look at Asciidoc, they should look at Asciidoctor, an extended language: It would seem to fit particularly well, because it was specifically designed to cover DocBook as much as possible. That both helps with conversion and with the sematic markup requirements. - Source: Hacker News / almost 2 years ago

Do you know an article comparing Asciidoctor to other products?
Suggest a link to a post with product alternatives.