diff --git a/docs/front-matter.md b/docs/front-matter.md
new file mode 100644
index 0000000..f98ebb1
--- /dev/null
+++ b/docs/front-matter.md
@@ -0,0 +1,38 @@
+ ## Front Matter
+
+ **title:** the title which appears in `<title>` meta data and optionally at the top of pages.
+ **summary:** the data which appears in `<meta name="description"` and optionally as a summary of posts on index pages.
+ **description:** alias of summary, as above.
+ **image:** this drives any 'top of post' image (optional).
+ **alt:** the alt-text of the 'top of post' image. If not specified, the default alt-text is 'title:' front matter.
+ **caption:** the caption of the 'top of post' image (optional). Displayed below the image in a `<div class="article-image-caption">`.
+ **tags:** comma-separated post tags, e.g. `tags: tag1, tag2`. These will be passed to the bottom of the post in a tag cloud format.
+ **date:** the date in ISO 8601 standard `YYYY-MM-DD`. Time is optional but recommended to aid correct pagination order.
+
+ Compliant format examples:
+ * Date only:
+ * `2025-09-17`
+
+ * With seconds:
+ * `2025-09-17T14:35:20`
+ * `2025-09-17T14:35:20Z`
+ * `2025-09-17T14:35:20+02:00`
+ * `2025-09-17T14:35:20-05:00`
+
+ * Without seconds:
+ * `2025-09-17T14:35`
+ * `2025-09-17T14:35Z`
+ * `2025-09-17T14:35+02:00`
+ * `2025-09-17T14:35-05:00`
+
+ * Hour only:
+ * `2025-09-17T14`
+ * `2025-09-17T14Z`
+ * `2025-09-17T14+02:00`
+ * `2025-09-17T14-05:00`
+
+ Additionally, fractional seconds (e.g. `.123`) can be added but these are removed during build.
+
+ When no date is provided, the script defaults to the current build time.
+ **Note**: the date/time *will* change at every (re)build, so add a date.
+
diff --git a/docs/user-configuration.md b/docs/user-configuration.md
index 93ec960..3c50402 100644
--- a/docs/user-configuration.md
+++ b/docs/user-configuration.md
@@ -39,41 +39,3 @@ The desired URL of the archive output. Someone might prefer '/blog' so here is t
**TAGS_PAGE_TITLE = "tags and categories"**
Configurable Tags index page title which can appear on-page and will populate the <title> meta data.
- ## Front Matter
-
- **title:** the title which appears in `<title>` meta data and optionally at the top of pages.
- **summary:** the data which appears in `<meta name="description"` and optionally as a summary of posts on index pages.
- **description:** alias of summary, as above.
- **image:** this drives any 'top of post' image (optional).
- **alt:** the alt-text of the 'top of post' image. If not specified, the default alt-text is 'title:' front matter.
- **caption:** the caption of the 'top of post' image (optional). Displayed below the image in a `<div class="article-image-caption">`.
- **tags:** comma-separated post tags, e.g. `tags: tag1, tag2`. These will be passed to the bottom of the post in a tag cloud format.
- **date:** the date in ISO 8601 standard `YYYY-MM-DD`. Time is optional but recommended to aid correct pagination order.
-
- Compliant format examples:
- * Date only:
- * `2025-09-17`
-
- * With seconds:
- * `2025-09-17T14:35:20`
- * `2025-09-17T14:35:20Z`
- * `2025-09-17T14:35:20+02:00`
- * `2025-09-17T14:35:20-05:00`
-
- * Without seconds:
- * `2025-09-17T14:35`
- * `2025-09-17T14:35Z`
- * `2025-09-17T14:35+02:00`
- * `2025-09-17T14:35-05:00`
-
- * Hour only:
- * `2025-09-17T14`
- * `2025-09-17T14Z`
- * `2025-09-17T14+02:00`
- * `2025-09-17T14-05:00`
-
- Additionally, fractional seconds (e.g. `.123`) can be added but these are removed during build.
-
- When no date is provided, the script defaults to the current build time.
- **Note**: the date/time *will* change at every (re)build, so add a date.
-