--- a/Allura/allura/templates/jinja_master/lib.html
+++ b/Allura/allura/templates/jinja_master/lib.html
@@ -293,7 +293,10 @@
<h2 id="md_ex_pre{{id}}">Preformatted Text</h2>
<p>If you want some text to show up exactly as you write it, without
Markdown doing anything to it, just indent every line by at least 4
-spaces (or 1 tab).</p>
+spaces (or 1 tab). As an alternative to indenting, you can use 4 or
+more tildes before and after the text. See examples in the
+<a href="#md_ex_code">Code Highlighting section</a>
+</p>
<div class="codehilite"><pre>
This line won't *have any markdown* formatting applied.
I can even write <b>HTML</b> and it will show up as text.
@@ -301,9 +304,8 @@
Markdown. <b>this won't show up as HTML</b> but
exactly <i>as you see it in this text file</i>.
-As a shortcut you can use backquotes to do the same thing while
-inside a normal pargraph. `This won't be *italic* or **bold**
-at all.`
+Within a paragraph, you can use backquotes to do the same thing.
+`This won't be *italic* or **bold** at all.`
</pre></div>
<p>Output:</p>
@@ -314,9 +316,8 @@
Markdown. <b>this won't show up as HTML</b> but
exactly <i>as you see it in this text file</i>.
-As a shortcut you can use backquotes to do the same thing while
-inside a normal pargraph. `This won't be *italic* or **bold**
-at all.`""")}}
+Within a paragraph, you can use backquotes to do the same thing.
+`This won't be *italic* or **bold** at all.`""")}}
</div>