4 ms·
For what it's worth, there's also `asciidoc` and its implementation asciidoctor (http://asciidoctor.org http://asciidoctor.org). It has an both official JVM and
by shadowfiend 11y ago
For what it's worth, there's also `asciidoc` and its implementation asciidoctor (http://asciidoctor.org http://asciidoctor.org). It has an both official JVM and JS packages in addition to the Ruby version, as well.
Notably missing is math support, however, because rather than Madoko's approach of using LaTeX and then using a LaTeX-to-HTML renderer, asciidoc renders directly to HTML (or Docbook, or LaTeX). IMO, the end result doesn't necessarily look like an academic article placed on an HTML page… But it's nicer for consumption in a browser—the whole asciidoctor site is generated from asciidoctor.
EDIT: this means asciidoc is a better fit for documentation, in book or article or whatever form—but I think once it gains math support (which they're working on) it would be quite useful for this as well.
- krapht 11y agoI don't understand what you mean about lacking math support. I am writing math exercises using asciidoctor right now, as it integrates with Mathjax. I would highly recommend asciidoc over markdown for scholarly work in succint plain text. Markdown is limited in its capabilities by design, as evidenced by all the different flavors of Markdown extension. It's what I would use to write an e-mail or blog post. Asciidoc, in the design of the language, anticipated extension and post-processing and has better support for using it as part of a complete document processing toolchain. After all, it's just syntax sugar for DocBook XML.