Update and clarify option documentation
Add markdown option to README
Merge pull request #490 from presidentbeef/option_documentation_updates

Option documentation updates