ref: f04006978ae8c7f630c4b5944b69679ad50d806a
parent: 8f9cea7f58e8acbffd2a14bc41225f4609963584
author: Joel Scoble <[email protected]>
date: Mon Nov 24 13:31:00 EST 2014
update summary.md with info on handling of html tags
--- a/docs/content/content/summaries.md
+++ b/docs/content/content/summaries.md
@@ -18,6 +18,8 @@
By default, Hugo automatically splits content after 70 words, with the content prior to the split being used for the content summary. This way you don't have to worry about content summary unless you want to customize it; the summary is automatically created for you, and available to be used by Hugo, without any additional work on your part.
+When using automatic summaries, Hugo will strip all HTML tags from the summary.
+
## User-defined: manual summary split:
Hugo also provides an easy way to customize where a piece of content will be split with its summary content divider: <code><!--more--></code>. The summary content divider is Hugo's version of a "more tag", "summary divider", "excerpt separator", etc. found in other systems. For the summary content divider to be valid, it most be entered as <code><!--more--></code>; with no additional spaces or other characters between the `<code>` and `</code>` tags.
@@ -24,6 +26,6 @@
If the summary content divider exists within a piece of content, Hugo will split the content at that point, instead of its default split point of 70 words. The content prior to the summary content provider will be used as that content's summary and the summary content divider will be replaces with a `Read More` link. When the full content is rendered, the summary content provider, <code><!--more--></code>, is elided from the output.
-A primary benefit of using <code><!--more--></code> is that a user-defined summary split preserves all of the summary formatting.
+When using user-defined summaries, <code><!--more--></code>, Hugo will preserve the HTML in the summary.
The summary content divider only applies to the content that it appears in.