resolves #168 clarifies link macro use cases

- adds new examples to URL section
- creates url include files
- adds image of a basic url