added more detail to the markdown script