revise markdown for readability