use `namespace` option if set

Add documentation for new option
Add markdown extension & formatting to readme file
Also fixed missing quote mark in package.json