Adding examples to markdown documentation.
This PR updates the markdown docs page to include the results of example code and to use syntax highlighting more consistently within that page.
This PR updates the markdown docs page to include the results of example code and to use syntax highlighting more consistently within that page.