Rustdoc: reStructuredText vs Markdown

On the other hand, it seems clear that Markdown (in any of the common varieties) is not extensible enough. So, it does seem like some change is needed.

I believe Asciidoctor is the best choice to enhance Rust's markup:

  1. Asciidoctor is Markdown compatible and supports its basic syntax.
  2. You can write your scientific articles and thesis with Asciidoctor: (example Enhance Embedded System Security With Rust
  3. The Asciidoctor tool-chain can render ".pdf", "html5", ebook, slides, ... with or without docbook.
5 Likes