improved md file