diff --git a/docs/userGuide/plugins/filterTags.mbdf b/docs/userGuide/plugins/tags.mbdf
similarity index 97%
rename from docs/userGuide/plugins/filterTags.mbdf
rename to docs/userGuide/plugins/tags.mbdf
index cd1e6335c2..15e057d445 100644
--- a/docs/userGuide/plugins/filterTags.mbdf
+++ b/docs/userGuide/plugins/tags.mbdf
@@ -1,7 +1,9 @@
-#### `filterTags`: Toggling alternative contents in a page
+## Tags
You can use tags to selectively filter HTML elements when building a site.
+### Toggling alternative contents in a page
+
Tags are specified by the `tags` attribute, **and can be attached to any HTML element**. During rendering, only elements that match tags specified in the `site.json` files will be rendered.
@@ -81,7 +83,7 @@ Alternatively, you can specify tags to render for a page in the front matter.
Tags in `site.json` will be merged with the ones in the front matter, and are processed after front matter tags. See [Hiding Tags](../tweakingThePageStructure.html#hiding-tags) for more information.
-#### Advanced Tagging Tips
+### Advanced Tagging Tips
You can use a `*` in a tag name to match elements more generally. A `*` in a tag will match any number of characters at its position.
@@ -103,7 +105,7 @@ All 3 `
`s will be shown.
-#### Hiding Tags
+### Hiding Tags
Using `-` at the start of a tag hides all tags matching the expression. This is helpful for disabling a group of tags and enabling a particular tag.
diff --git a/docs/userGuide/tweakingThePageStructure.md b/docs/userGuide/tweakingThePageStructure.md
index 22b4b3a479..ddc5970bf2 100644
--- a/docs/userGuide/tweakingThePageStructure.md
+++ b/docs/userGuide/tweakingThePageStructure.md
@@ -4,7 +4,7 @@
title: "User Guide: {{ title }}"
layout: userGuide
- pageNav: 3
+ pageNav: 2
@@ -43,7 +43,7 @@
-
+
{% from "njk/common.njk" import previous_next %}
{{ previous_next('usingPlugins', 'reusingContents') }}
diff --git a/docs/userGuide/usingPlugins.md b/docs/userGuide/usingPlugins.md
index 9bcec0418d..e154828d93 100644
--- a/docs/userGuide/usingPlugins.md
+++ b/docs/userGuide/usingPlugins.md
@@ -228,7 +228,7 @@ MarkBind has a set of built-in plugins that can be used immediately without inst
-
+
{% from "njk/common.njk" import previous_next %}