use markdown more wisely