Add doc for Blackfriday configuration

See #686
Add ability to canonify URLs in rendered XML output.
Merge pull request #742 from bjornerik/doc/blackfriday

Add doc for Blackfriday configuration
Fix a crash for ref page#anchor.

- Remove an improperly shadowed variable.
- Fixes #741.
Add anchor ref to Blackfriday doc