Update markdown, syntax highlighting and few minor fixes

Code fenced blocks can't be indented and require an empty line both before and after.