Update markdown, syntax highlighting and few minor fixes

Is this still a valid PR if I add empty line before and after the fenced block?