[type0]

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.

== 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]

[dgfgfdagasdfgfa]

> . first adoc - auto numbering

That looks like a bullet to me. How do you differentiate unordered and ordered lists?

Also, markdown auto-numbers too, so you can just prefix every item with `1` if you'd like.

[type0]

> 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

You could also do:

[start=5]

. nr-5

. nr-6

. nr-7