I wonder also, gitbook-cli supports both md and adoc. Asciidoctor is easier to write and you don't have to use its advanced features for it to become superior to Markdown.
> so you can just prefix every item with `1` if you'd like.
oh, didn't knew that, use asterisks instead of dots is for bulletspoints in asciidoc. For unordered lists use more than one asterisk (HN breaks my example here), look at this example http://www.methods.co.nz/asciidoc/chunked/ch17.html if you mean Implicit numbering
== What is easier to write?
<!-- md comment -->
or
// adoc comment
== What is easier to write?
<a href="http://foo.com"></a>
or
image:adoc-foo.jpg[link="http://foo.com"]
== What is easier to write?
1. first md - no auto numbering
2. second md - no auto numbering
3. third md - no auto numbering
or
. first adoc - auto numbering
. second adoc - auto numbering
. third adoc - auto numbering
What is easier to write?
[Get the PDF]({% raw %}{{ site.url }}{% endraw %}/assets/my-md-file.pdf)
or
link:{ctx_path}/assets/my-adoc-file.pdf[Get the PDF]