md file improvements