more tries at fixing markdown about markdown

for some reason, GitHub enging for parsing markdown is causing server
500 - trying to debug and fix this behavior (first commit was ok and
server was rendering more or less correctly with only few
misinterpretings - like those with links and escaping, so thats why
following commits with in blind fixes may occure; GitHub support was
notified about it, claiming they will check it when they have time).