From 8f07e8901e964f51cf7d7e75a4b624479ea0c33a Mon Sep 17 00:00:00 2001
From: Ze Yu <angzeyu@gmail.com>
Date: Wed, 30 Dec 2020 20:00:27 +0800
Subject: [PATCH] Whitelist <markdown> and <md> as special tags

---
 .../functional/test_site/expected/index.html  | 16 ++++++++++++++
 .../cli/test/functional/test_site/index.md    | 21 +++++++++++++++++++
 .../markdown-it-escape-special-tags.js        |  2 +-
 packages/core/src/patches/htmlparser2.js      |  2 ++
 4 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/packages/cli/test/functional/test_site/expected/index.html b/packages/cli/test/functional/test_site/expected/index.html
index 6b13f87a3e..3c12bf9fd8 100644
--- a/packages/cli/test/functional/test_site/expected/index.html
+++ b/packages/cli/test/functional/test_site/expected/index.html
@@ -180,6 +180,22 @@ <h3 id="testing-site-nav"><span id="testing-site-nav" class="anchor"></span>Test
       <div id="content-wrapper" class="fixed-header-padding">
 
         <div class="website-content">
+          <p><strong>Test <code class="hljs inline no-lang" v-pre>&lt;markdown&gt;</code> and <code class="hljs inline no-lang" v-pre>&lt;md&gt;</code> elements</strong></p>
+          <div>
+            <p>This should be wrapped in a <code class="hljs inline no-lang" v-pre>&lt;p&gt;</code> tag as it uses the block-level markdown renderer</p>
+          </div>
+          <span>This should not be wrapped in a <code class="hljs inline no-lang" v-pre>&lt;p&gt;</code> tag as it uses the inline markdown renderer</span>
+          <div class="mt-2">
+            <pre><code class="hljs" v-pre><span>&lt;markdown&gt; elements allow block-level markdown without needing a leading newline.
+</span><span>Hence, this html should be parsed and output as is, without any parsing errors.
+</span><span>&lt;/invalidhtml&gt;
+</span></code></pre>
+          </div>
+          <span>
+            <code class="hljs inline no-lang" v-pre>&lt;md&gt;</code> elements allow block-level markdown without needing a leading newline.
+            Hence, this html should be parsed and output as is, without any parsing errors.
+            <code class="hljs inline no-lang" v-pre>&lt;/invalid&gt;</code>.
+          </span>
           <p><strong>Test footnotes</strong></p>
           <div>
             <p><strong>Normal footnotes:</strong>
diff --git a/packages/cli/test/functional/test_site/index.md b/packages/cli/test/functional/test_site/index.md
index a85f3562a5..466726db00 100644
--- a/packages/cli/test/functional/test_site/index.md
+++ b/packages/cli/test/functional/test_site/index.md
@@ -10,6 +10,27 @@ tags: ["tag-frontmatter-shown", "tag-included-file", "+tag-exp*", "-tag-exp-hidd
 
 <div class="website-content">
 
+**Test `<markdown>` and `<md>` elements**
+
+<markdown>This should be wrapped in a `<p>` tag as it uses the block-level markdown renderer</markdown>
+
+<md>This should not be wrapped in a `<p>` tag as it uses the inline markdown renderer</md>
+
+<markdown class="mt-2">
+```
+<markdown> elements allow block-level markdown without needing a leading newline.
+Hence, this html should be parsed and output as is, without any parsing errors.
+</invalidhtml>
+```
+</markdown>
+
+<md>
+`<md>` elements allow block-level markdown without needing a leading newline.
+Hence, this html should be parsed and output as is, without any parsing errors.
+`</invalid>`.
+</md>
+
+
 **Test footnotes**
 
 <include src="testFootnotes.md" />
diff --git a/packages/core/src/lib/markdown-it/markdown-it-escape-special-tags.js b/packages/core/src/lib/markdown-it/markdown-it-escape-special-tags.js
index 23f191461d..a65b3475ba 100644
--- a/packages/core/src/lib/markdown-it/markdown-it-escape-special-tags.js
+++ b/packages/core/src/lib/markdown-it/markdown-it-escape-special-tags.js
@@ -10,7 +10,7 @@ function escape_plugin(md, tagsToIgnore) {
   const HTML_OPEN_CLOSE_TAG_RE = require('markdown-it/lib/common/html_re').HTML_OPEN_CLOSE_TAG_RE;
 
   const specialTagsRegex = Array.from(tagsToIgnore)
-    .concat(['script|pre|style|variable|site-nav'])
+    .concat(['script|pre|style|variable|site-nav|markdown|md'])
     .join('|');
 
   // attr_name, unquoted ... attribute patterns adapted from markdown-it/lib/common/html_re
diff --git a/packages/core/src/patches/htmlparser2.js b/packages/core/src/patches/htmlparser2.js
index e7726da87b..aa62707d1b 100644
--- a/packages/core/src/patches/htmlparser2.js
+++ b/packages/core/src/patches/htmlparser2.js
@@ -142,6 +142,8 @@ const DEFAULT_SPECIAL_TAGS = [
 	'script',
 	'style',
 	'variable',
+	'markdown',
+	'md',
 ];
 
 function whitespace(c) {