From 7949ada63d285eadd9aea9c1fcd029b4ce7f7c8c Mon Sep 17 00:00:00 2001
From: Mark Dumay <61946753+markdumay@users.noreply.github.com>
Date: Sat, 28 Mar 2026 13:14:35 +0100
Subject: [PATCH 1/2] feat: describe clear separator

---
 content/blocks/separator.md | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/content/blocks/separator.md b/content/blocks/separator.md
index 551737e..529abf4 100644
--- a/content/blocks/separator.md
+++ b/content/blocks/separator.md
@@ -2,8 +2,8 @@
 _schema: default
 title: Separator
 description: >-
-  Adds a horizontal section separator. The separator spans the entire page from
-  edge to edge on smaller devices. On larger screens, the line is bound by the
+  Adds a section separator. The separator spans the entire page from edge to
+  edge on smaller devices. On larger screens, the separator is bound by the
   maximum container width that contains the section.
 type: docs
 tags: block
@@ -11,13 +11,33 @@ tags: block
 
 ## Overview
 
-The `separator` content block renders a horizontal line to separate sections. The separator spans the entire page from edge to edge on smaller devices. On larger screens, the line is bound by the maximum container width that contains the section.
+The `separator` content block renders a section separator. The separator spans the entire page from edge to edge on smaller devices. On larger screens, the separator is bound by the maximum container width that contains the section.
+
+### Line separator
+
+The default separator renders a horizontal line.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: separator
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+### Clear separator
+
+Set the argument `clear: true` to render a clear separator.
 
 <!-- markdownlint-disable MD037 -->
 {{< example-bookshop lang="bookshop" >}}
 
 ```yml
 - _bookshop_name: separator
+  clear: true
+  section_class: bg-info
 ```
 
 {{< /example-bookshop >}}

From cf3ee3e62464f9e47506cfb75469c6325288d5c3 Mon Sep 17 00:00:00 2001
From: Mark Dumay <61946753+markdumay@users.noreply.github.com>
Date: Sat, 28 Mar 2026 13:14:51 +0100
Subject: [PATCH 2/2] feat: document heading block

---
 content/blocks/heading.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 content/blocks/heading.md

diff --git a/content/blocks/heading.md b/content/blocks/heading.md
new file mode 100644
index 0000000..2453b74
--- /dev/null
+++ b/content/blocks/heading.md
@@ -0,0 +1,33 @@
+---
+_schema: default
+title: Heading
+description: Use the heading content block to show a heading with optional regular content.
+type: docs
+tags: block
+---
+
+## Overview
+
+The `heading` content block renders a section heading with optional regular content.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: heading
+  heading:
+    preheading: Preheading
+    title: Section heading
+    content: Regular content that is placed below the title.
+  width: 8
+  justify: center
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-heading >}}