If you love Asciidoc and want to generate cool technical specs in HTML5 and RevealJS slide for technical showcase. This gradle plugin can help:
Creating a sane default structure for project docos and templates Generating HTML5 docos (PlantUML supported) Generating RevealJS slide from Asciidoc format To work with Asciidoc, refer to this writer’s guide, and compare Asciidoc with markdown, also heap of projects are using Asciidoc