updated markdown with code blocks when necessary