extract method to create document output specification
add "content type" to output document specification
introduce and use some properties:

- ContentType string property
- ConvertToHTML boolean property
generate markdown instead of HTML docs - update output generated for code blocks
small documentation improvements
reference code by file again