changing doc format and HTML literals

site/doc/pages/html_escape.txt

@@ -5,13 +5,15 @@ String html_escape(String s)
 s : string to be escaped
 return value : an HTML-safe escaped version of 's'
 
-:desc
-Returns a version of the input string where the following characters have been replace by HTML entities:
-- & → &amp
-- < → lt;
-- > → &gt;
-- " → &quot;
+:content
+Returns a version of the input string where special HTML characters are replaced by entities:
 
-:related
-**PHP:** `htmlspecialchars()` or `htmlentities()`
-**JavaScript / Node.js:** Safe text insertion via `textContent` or server-side HTML escaping libraries
+- `&` becomes `&amp;`
+- `<` becomes `&lt;`
+- `>` becomes `&gt;`
+- `"` becomes `&quot;`
+
+## Related Concepts
+
+- PHP: `htmlspecialchars()` or `htmlentities()`
+- JavaScript / Node.js: safe text insertion via `textContent` or server-side HTML escaping libraries