Asciidoctor is a document format and publishing tool that focuses on content over formatting. It allows embedding of diagrams and code snippets. It supports multiple output formats and has build integration. Asciidoctor is actively being developed and many open source projects use it for documentation.

1. ASCIIDOCTOR IN 15MIN
Schalk W. Cronjé

2. WHY?
Focus on content, not formatting
Source-control friendly
No proprietary source format
More powerful than Markdown, including
Github MD
Leanpub Markuva
More user friendly than RText or LaTeX
No need to fight Docbook

3. STATE OF SIMPLE PUBLISING 2014

4. FLAVOURS
Asciidoctor (Ruby)
Asciidoctorj (JVM)
Asciidoctorjs (Javascript)
Original Asciidoc (Python).

5. STATE OF ASCIIDOCTOR 2015

6. DRAWING SUPPORT
PlantUML
Ditaa
Shaape
BlockDiag, SeqDiag, ActDiag, NwDiag
GraphViz DOT
Via asciidoctor-diagram module

7. DRAWING SUPPORT
+-------------+
| Asciidoctor |-------+
| diagram | |
+-------------+ | PNG out
^ |
| ditaa in |
| v
+--------+ +--------+----+ /---------------
| | --+ Asciidoctor +--> | |
| Text | +-------------+ | Beautiful |
|Document| | !magic! | | Output |
| {d}| | | | |
+---+----+ +-------------+ ---------------/

8. SOURCE CODE HIGHLIGHTING
[source,cpp]
----
int main(int argc,char** argv) {
std::cout << "Hello, world!" << std::endl;
}
----
int main(int argc,char** argv) {
std::cout << "Hello, world!" << std::endl;
}

9. MATH EQUATIONS
Asciimath
Latexmath
Limitation: Conversion rendered in cloud

10. BUILDTOOL SUPPORT
Maven
Gradle
Ant
Leiningen
SBT
Grunt

11. PROJECTS
A number of projects use Asciidoctor for documentation
complete with tested code snippets, including:
Groovy Language
Spring
Griffon

12. ACTIVELY IN THE WORKS
Asciidoctor → Leanpub
Asciidoctor → Mallard
Asciidoctor → LaTeX
Asciidoctor → Pdf
Asciidoctor → Epub

13. ABOUT THIS PRESENTATION
Written in Asciidoctor
Styled by asciidoctor-revealjs extension
Built using:
Gradle
gradle-asciidoctor-plugin
gradle-vfs-plugin
https://bitbucket.org/ysb33r/asciidoctorinanutshell

14. DEMO

15. THANK YOU
Schalk W. Cronjé
ysb33r@gmail.com
@ysb33r
Read more at http://asciidoctor.org