Improve documention of markdown, and ID generation.