use markdown better (where possible)