DEV Community

Discussion on: A short-list with documentation generators in 2019

Collapse
 
evanoman profile image
Evan Oman

I am a huuge fan of AsciiDoc. The syntax is very similar to MarkDown, making the source easily readable. However it has a lot of extra features for rendering and composing source files so can be used to build all sorts of documents. You can render the same source into HTML, PDF, DocBook, and even a man-page format. Plus the tooling is available on CLI and in our Java Gradle projects using AsciiDoctorJ.

Collapse
 
pingvin235 profile image
Shamil Vakhitov

AsciiDoctor is cool, here is an extended and more production ready generator on top of AsciiDoctorJ: pzdcdoc.org

Collapse
 
sm0ke profile image
Sm0ke

The post-processing translation to PDF, EPUB ... can be very useful.
I will add it to the list.
Also, feel free to share a documentation project, in the case is public.