From 09acf1aec7c59057f46b8f9fe7aae7f63523a076 Mon Sep 17 00:00:00 2001
From: Hashim Khan <sardarhashim30@gmail.com>
Date: Thu, 23 Jul 2026 07:40:00 +0500
Subject: [PATCH] docs(unescaped-markup): remove duplicated How to use,
 Examples, and FAQ sections

The Examples demos embedded a full page that re-rendered those headings on the docs site. Replace them with short samples so each section appears once.

Fixes #4038
---
 src/plugins/unescaped-markup/README.md | 109 ++-----------------------
 1 file changed, 5 insertions(+), 104 deletions(-)
diff --git a/src/plugins/unescaped-markup/README.md b/src/plugins/unescaped-markup/README.md
index 7847526e69..6289a14de1 100644
--- a/src/plugins/unescaped-markup/README.md
+++ b/src/plugins/unescaped-markup/README.md
@@ -34,113 +34,14 @@ This will only work if the `code` element contains exactly one comment and nothi
 
 # Examples
 
-View source to see that the following didn’t need escaping (except for <code>&lt;/script></code>, that does):
-
-<script type="text/plain"><!DOCTYPE html>
-<html lang="en">
-<head>
-
-	<meta charset="utf-8" />
-	<link rel="icon" href="https://prismjs.com/assets/favicon.png" />
-	<title>Keep markup ▲ Prism plugins</title>
-	<base href=".." />
-	<link rel="stylesheet" href="https://prismjs.com/assets/style.css" />
-	<link rel="stylesheet" href="https://dev.prismjs.com/themes/prism.css" />
-
-</head>
-<body class="language-markup">
-
-<header>
-	<h2>Unescaped markup</h2>
-	<p>Write markup without having to escape anything.</p>
-</header>
-
-<section>
-	<h1>How to use</h1>
-	<p>Instead of using <code>&lt;pre>&lt;code></code> elements, use <code>&lt;script type="text/plain"></code>:</p>
-</section>
-
-<section>
-	<h1>FAQ</h1>
-
-	<p>Why not use the HTML <code>&lt;template></code> tag?</p>
-
-	<p>Because it is a PITA to get its <code>textContent</code> and needs to be pointlessly cloned.
-		Feel free to implement it yourself and send a pull request though, if you are so inclined.</p>
-
-	<p>Can I use this inline?</p>
-
-	<p>Not out of the box, because I figured it’s more of a hassle to type <code>&lt;script type="text/plain"></code> than escape the 1-2 <code>&lt;</code> characters you need to escape in inline code.
-	Also inline code is not as frequently copy-pasted, which was the major source of annoyance that got me to write this plugin.</p>
-</section>
-
-<section>
-	<h1>Examples</h1>
-
-	<p>With <code>&lt;script type="text/plain"></code>:</p>
-
-	<script type="text/plain"><div><span>Foo</span></div>&lt;/script>
-</section>
-
-<script src="https://dev.prismjs.com/prism.js">&lt;/script>
-<script src="unescaped-markup/unescaped-markup.js">&lt;/script>
-
-</body>
-</html></script>
-
-<p>The next example uses the HTML-comment method:</p>
-
-<pre><code><!--<!DOCTYPE html>
-<html lang="en">
-<head>
+With `<script type="text/plain">` (view source; only `</script>` needs escaping):
 
-	<meta charset="utf-8" />
-	<link rel="icon" href="https://prismjs.com/assets/favicon.png" />
-	<title>Keep markup ▲ Prism plugins</title>
-	<base href=".." />
-	<link rel="stylesheet" href="https://prismjs.com/assets/style.css" />
-	<link rel="stylesheet" href="https://dev.prismjs.com/themes/prism.css" />
-
-</head>
-<body class="language-markup">
-
-<header>
-	<h2>Unescaped markup</h2>
-	<p>Write markup without having to escape anything.</p>
-</header>
-
-<section>
-	<h1>How to use</h1>
-	<p>Instead of using <code>&lt;pre>&lt;code></code> elements, use <code>&lt;script type="text/plain"></code>:</p>
-</section>
-
-<section>
-	<h1>FAQ</h1>
-
-	<p>Why not use the HTML <code>&lt;template></code> tag?</p>
-
-	<p>Because it is a PITA to get its <code>textContent</code> and needs to be pointlessly cloned.
-		Feel free to implement it yourself and send a pull request though, if you are so inclined.</p>
-
-	<p>Can I use this inline?</p>
-
-	<p>Not out of the box, because I figured it’s more of a hassle to type <code>&lt;script type="text/plain"></code> than escape the 1-2 <code>&lt;</code> characters you need to escape in inline code.
-	Also inline code is not as frequently copy-pasted, which was the major source of annoyance that got me to write this plugin.</p>
-</section>
-
-<section>
-	<h1>Examples</h1>
-
-	<p>With <code>&lt;script type="text/plain"></code>:</p>
-
-	<script type="text/plain"><div><span>Foo</span></div></script>
-</section>
+<script type="text/plain"><p>Example with <strong>unescaped</strong> markup</p>
+</script>
 
-<script src="https://dev.prismjs.com/prism.js"></script>
-<script src="unescaped-markup/unescaped-markup.js"></script>
+With the HTML-comment method:
 
-</body>
-</html>--></code></pre>
+<pre><code><!--<p>Example with <strong>unescaped</strong> markup</p>--></code></pre>
 
 </section>
 
