[doc/deploy][s]: tweak markdown formatting.

* fine locally but on github ul's are not working right