Comment by EligibleDecoy

I really agree. All of our team documentation is in asciidoc. Importing diagrams from other files, variables, and vastly better tables are the best features for us. I feel like asciidoc’s weakness is that there is only 1 library, and it’s in ruby. Whereas markdown has libraries in almost all languages, making it easier to support.