diff --git a/exampleSite/content.en/docs/shortcodes/katex.md b/exampleSite/content.en/docs/shortcodes/katex.md
index f292ca13ed7746353af15449b49720687891389a..0b7b236fb48ac8cbe2e40269dfa7d12a588aaf75 100644
--- a/exampleSite/content.en/docs/shortcodes/katex.md
+++ b/exampleSite/content.en/docs/shortcodes/katex.md
@@ -6,26 +6,30 @@ title: KaTeX
 KaTeX shortcode let you render math typesetting in markdown document. See [KaTeX](https://katex.org/)
 
 ## Example
-{{< columns >}}
+
+<div class="book-columns flex flex-wrap">
+  <div class="flex-even markdown-inner">
 
 ```latex
-{{</*/* katex [display] [class="text-center"] */*/>}}
+{{</* katex display=true class="optional" >}}
 f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
-{{</*/* /katex */*/>}}
+{{< /katex */>}}
 ```
 
-<--->
+  </div>
+  <div class="flex-even markdown-inner">
 
-{{< katex display >}}
+{{< katex display=true class="optional" >}}
 f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
 {{< /katex >}}
 
-{{< /columns >}}
+  </div>
+</div>
 
 ## Display Mode Example
 
 Here is some inline example: {{< katex >}}\pi(x){{< /katex >}}, rendered in the same line. And below is `display` example, having `display: block`
-{{< katex display >}}
+{{< katex display=true >}}
 f(x) = \int_{-\infty}^\infty\hat f(\xi)\,e^{2 \pi i \xi x}\,d\xi
 {{< /katex >}}
 Text continues here.
diff --git a/exampleSite/content.en/docs/shortcodes/mermaid.md b/exampleSite/content.en/docs/shortcodes/mermaid.md
index a9ed4d48ba4df6d7c87f0f5c5ebdee4cff31948a..09eecea23b113316804203012eb37b0cd6205ba7 100644
--- a/exampleSite/content.en/docs/shortcodes/mermaid.md
+++ b/exampleSite/content.en/docs/shortcodes/mermaid.md
@@ -11,9 +11,12 @@ create a `mermaid.json` file in your `assets` folder!
 
 ## Example
 
-{{< columns >}}
+
+<div class="book-columns flex flex-wrap">
+  <div class="flex-even markdown-inner">
+
 ```tpl
-{{</*/* mermaid [class="text-center"]*/*/>}}
+{{</* mermaid class="optional" >}}
 stateDiagram-v2
     State1: The state with a note
     note right of State1
@@ -22,12 +25,13 @@ stateDiagram-v2
     end note
     State1 --> State2
     note left of State2 : This is the note to the left.
-{{</*/* /mermaid */*/>}}
+{{< /mermaid */>}}
 ```
 
-<--->
+  </div>
+  <div class="flex-even markdown-inner">
 
-{{< mermaid >}}
+{{< mermaid class="optional" >}}
 stateDiagram-v2
     State1: The state with a note
     note right of State1
@@ -38,4 +42,5 @@ stateDiagram-v2
     note left of State2 : This is the note to the left.
 {{< /mermaid >}}
 
-{{< /columns >}}
+  </div>
+</div>
\ No newline at end of file
diff --git a/layouts/shortcodes/html.html b/layouts/shortcodes/html.html
new file mode 100644
index 0000000000000000000000000000000000000000..141a3a84297d4f7e3e793b2b3fd03e65ef4356f5
--- /dev/null
+++ b/layouts/shortcodes/html.html
@@ -0,0 +1 @@
+{{- .Inner -}}
\ No newline at end of file
diff --git a/layouts/shortcodes/katex.html b/layouts/shortcodes/katex.html
index c83135eb64ce165caa4618223bf9d5c031e920a8..cb7f6f20fa1c8975b4692cb7df26137a6763431e 100644
--- a/layouts/shortcodes/katex.html
+++ b/layouts/shortcodes/katex.html
@@ -7,7 +7,7 @@
 {{- end -}}
 
 <span {{- with .Get "class" }} class="{{ . }}"{{ end }}>
-  {{ cond (in .Params "display") "\\[" "\\(" -}}
+  {{ with .Get "display" }}\[{{else}}\({{end}}
   {{- trim .Inner "\n" -}}
-  {{- cond (in .Params "display") "\\]" "\\)" }}
+  {{ with .Get "display" }}\]{{else}}\){{end}}
 </span>