Add doc for Blackfriday configuration

See #686
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
[Docs] Add a note about the plan to switch to Apache License