Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Markdown is definitely far more popular, but I see more book-length specification type documents written in Asciidoc. For example the RISC-V spec, or Ferrocene's Rust spec.


I've written and published books (both physical and ebooks) with rST, asciidoc, and md. No format is perfect, but of those three md works best for me.




Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: