Skip to content
Permalink
Browse files

Update shortcode docs vs 0.55

  • Loading branch information...
bep committed Apr 18, 2019
1 parent 9a7e192 commit 13097daf2e22fabfdb7528ca8709e86dba2b4a72
Showing with 5 additions and 2 deletions.
  1. +5 −2 content/en/content-management/shortcodes.md
@@ -53,12 +53,15 @@ The examples above use two different delimiters, the difference being the `%` ch

### Shortcodes with Markdown

The `%` character indicates that the shortcode's inner content---called in the [shortcode template][sctemps] with the [`.Inner` variable][scvars]---needs further processing by the page's rendering processor (i.e. markdown via Blackfriday). In the following example, Blackfriday would convert `**World**` to `<strong>World</strong>`:
In Hugo `0.55` we changed how the `%` delimiter works. Shortcodes using the `%` as the outer-most delimiter will now be fully rendered when sent to the content renderer (e.g. Blackfriday for Markdown), meaning they can be part of the generated table of contents, footnotes, etc.

If you want the old behavior, you can put the following line in the start of your shortcode template:

```
{{%/* myshortcode */%}}Hello **World!**{{%/* /myshortcode */%}}
{{ $_hugo_config := `{ "version": 1 }` }}
```


### Shortcodes Without Markdown

The `<` character indicates that the shortcode's inner content does *not* need further rendering. Often shortcodes without markdown include internal HTML:

0 comments on commit 13097da

Please sign in to comment.
You can’t perform that action at this time.