>But HTML documents are much easier to read, [than markdown]

Presumably you mean rendered HTML rather than the source documents?