diff --git a/docs/userGuide/plugins/filterTags.mbdf b/docs/userGuide/plugins/filterTags.mbdf
index 4b63f6ce42..cd1e6335c2 100644
--- a/docs/userGuide/plugins/filterTags.mbdf
+++ b/docs/userGuide/plugins/filterTags.mbdf
@@ -110,9 +110,7 @@ Using `-` at the start of a tag hides all tags matching the expression. This is
```
-```json
-site.json
-
+```json {heading="site.json"}
{
...
"plugins" : [
diff --git a/docs/userGuide/syntax/pageHead.mbdf b/docs/userGuide/syntax/pageHead.mbdf
index 043caad28c..8975115082 100644
--- a/docs/userGuide/syntax/pageHead.mbdf
+++ b/docs/userGuide/syntax/pageHead.mbdf
@@ -10,13 +10,11 @@ Steps:
{{ icon_example }} Suppose you want to insert the code below into the `` of a page, and you have saved the code as **`_markbind/head/`**`myCustomLinks.md`:
-
-
-``
-``
-``
-
-
+```html{.no-line-numbers}
+
+
+
+```
To specify that you want to insert `myCustomLinks.md` into the `` of `myPage.html`, update the front matter of the `myPage.md` as follows:
```html
@@ -34,15 +32,13 @@ To specify that you want to insert `myCustomLinks.md` into the `` of `myPa
{{ icon_example }} Here's how you can force the line `` to be inserted at the top of the `` section.
-
-
-**``**
- ``
-**``**
-``
-``
-
-
+```html {.no-line-numbers highlight-lines="1,3"}
+
+
+
+
+
+```
@@ -62,15 +58,13 @@ To specify that you want to insert `myCustomLinks.md` into the `` of `myPa
`_markbind/head/myCustomLinks.md`:
-
-
-**``**
- ``
-**``**
-``
-``
-
-
+```html{.no-line-numbers highlight-lines="1,3"}
+
+
+
+
+
+```
```html
diff --git a/docs/userGuide/syntax/pageLayouts.mbdf b/docs/userGuide/syntax/pageLayouts.mbdf
index 84af369ca1..f5fe9e24d5 100644
--- a/docs/userGuide/syntax/pageLayouts.mbdf
+++ b/docs/userGuide/syntax/pageLayouts.mbdf
@@ -1,3 +1,6 @@
+
{{ MAIN_CONTENT_BODY }}
@@ -11,7 +14,7 @@ A layout consists of the following files:
1. A footer (filename: `footer.md`)
1. Tweaks to the `` (`head.md`)
1. A site navigation menu (`navigation.md`)
-1. An expressive layout template to embed your content (`page.md`)
+1. An expressive layout template to embed your content (`page.md`)
1. Custom styles (`styles.css`)
1. Custom scripts (`scripts.js`)
@@ -114,27 +117,18 @@ which injects the actual page content in every page. This allows you to build la
{{ icon_example }} Adding statistics formula to the bottom of every page
-
-index.md
-
-
- ```html
+ ```html {heading="index.md"}
#### Main content of your page
Content of your page
```
-
-
-page.md
-
- {{ mainContentBody }}
- ```html
+ ```html {heading="page.md"}
+ {{ mainContentBody }}
```
-
Here's how the above content would appear:
diff --git a/docs/userGuide/syntax/siteNavigationMenus.mbdf b/docs/userGuide/syntax/siteNavigationMenus.mbdf
index 286062e4ce..73762da659 100644
--- a/docs/userGuide/syntax/siteNavigationMenus.mbdf
+++ b/docs/userGuide/syntax/siteNavigationMenus.mbdf
@@ -72,19 +72,17 @@ You may have additional HTML and Markdown content in a
-
-# Site Map
-<navigation>
-* [:house: Home]({{ showBaseUrlText }}/index.html)
-* Docs :expanded:
- * [User Guide]({{ showBaseUrlText }}/ug.html)
- * [Dev Guide]({{ showBaseUrlText }}/dg.html)
-* [Search]({{ showBaseUrlText }}/search.html)
-</navigation>
-
-
+```{.no-line-numbers}
+# Site Map
+
+* [:house: Home]({{ baseUrl }}/index.html)
+* Docs :expanded:
+ * [User Guide]({{ baseUrl }}/ug.html)
+ * [Dev Guide]({{ baseUrl }}/dg.html)
+* [Search]({{ baseUrl }}/search.html)
+
+```
```html