Asciidoctor
6.9#4 in documentation generatorsFree planFree planWebAPIExtensionLinux
VisitAsciidoctor vs RDoc
What both publish
| Fact | Asciidoctor | RDoc |
|---|---|---|
| License | The processor is open source software available under the MIT license. | RDoc is free software and may be redistributed under the terms in its license file. |
| Purpose | Asciidoctor parses AsciiDoc source and converts it into publishable formats such as HTML 5 and PDF. | RDoc produces HTML and command-line documentation for Ruby projects, with `rdoc` and `ri` tools to generate and display it. |
| Support | The documentation directs users seeking real-time community support to the project chat’s #users stream. | The project directs users to its contributing guide for filing bug reports and says problems producing desired output may be documentation bugs. |
Asciidoctor plans
- AsciidoctorFree
RDoc plans
- RDocFree
Pick Asciidoctor if…
Asciidoctor suits writers and developers publishing AsciiDoc across different formats and runtimes. Its command-line, API, and build-tool integrations also fit documentation workflows that use Ruby, Java, or JavaScript.
Pick RDoc if…
RDoc suits Ruby project maintainers who need generated API references, command-line documentation, and local previews on Linux or self-hosted systems. It also fits teams documenting Ruby, C, or RBS sources in automation workflows.