Add doc for Blackfriday configuration

See #686
This commit is contained in:
bep 2014-12-26 16:04:49 +01:00
parent fbf8bcacc4
commit a0fe117002
2 changed files with 24 additions and 0 deletions

View file

@ -93,3 +93,9 @@ Field names are always normalized to lowercase (e.g. `camelCase: true` is availa
*If neither `slug` or `url` is present, the filename will be used.*
## Configure Blackfriday rendering
It's possible to set some options for Markdown rendering in the page's front matter, as an override to the site wide configuration.
See [Configuration]({{< ref "overview/configuration.md" >}}) for more.

View file

@ -63,6 +63,24 @@ Here is a yaml configuration file which sets a few more options
SidebarRecentLimit: 5
...
## Configure Blackfriday rendering
[Blackfriday](https://github.com/russross/blackfriday) is the [Markdown](http://daringfireball.net/projects/markdown/) rendering engine used in Hugo. The Blackfriday configuration in Hugo is mostly a set of sane defaults that should fit most use cases.
But Hugo does expose some options -- in the table below matched with the corresponding flag in the [Blackfriday source](https://github.com/russross/blackfriday/blob/master/html.go):
Flag | Default | Blackfriday flag | Purpose
--- | --- | --- | ---
angledQuotes | false | HTML_SMARTYPANTS_ANGLED_QUOTES | Enable angled double quotes (`« »`)
**Note** that these flags must be grouped under the `blackfriday` key and can be set on **both site and page level**. If set on page, it will override the site setting.
```
blackfriday:
angledQuotes: true
```
## Notes
Config changes do not reflect with [Live Reload](/extras/livereload).