more updates to the markdown examples.