diff --git a/docs/example/example-core/src/commonMain/kotlin/Example.kt b/docs/example/example-core/src/commonMain/kotlin/Example.kt
index de910b3..b4c29b6 100644
--- a/docs/example/example-core/src/commonMain/kotlin/Example.kt
+++ b/docs/example/example-core/src/commonMain/kotlin/Example.kt
@@ -43,6 +43,26 @@ class Example() : MyInterface {
 	 *
 	 * This is a reference to a parameter: [bar].
 	 *
+	 * # Level 1
+	 *
+	 * This is a level 1 header.
+	 *
+	 * ## Level 2
+	 *
+	 * This is a level 2 header.
+	 *
+	 * ### Level 3
+	 *
+	 * This is a level 3 header.
+	 *
+	 * #### Level 4
+	 *
+	 * This is a level 4 header.
+	 *
+	 * ##### Level 5
+	 *
+	 * This is a level 5 header.
+	 *
 	 * @param bar This is a parameter.
 	 * @return This is a return type.
 	 */
diff --git a/renderer/src/jvmMain/kotlin/MethodGroupingTransformer.kt b/renderer/src/jvmMain/kotlin/MethodGroupingTransformer.kt
index 621da73..7770556 100644
--- a/renderer/src/jvmMain/kotlin/MethodGroupingTransformer.kt
+++ b/renderer/src/jvmMain/kotlin/MethodGroupingTransformer.kt
@@ -74,7 +74,11 @@ class MethodGroupingTransformer : PageTransformer {
 											alreadyMerged.add(memberPage)
 											allMergedPages.add(memberPage)
 											row.copy(
-												children = memberPage.content.children.map { it.demoteHeaders(2) }
+												children = memberPage.content.children.mapIndexed { index, child ->
+													// index == 0: first block in the page, description of the class
+													// index > 0: later blocks, method/property/constructor details
+													child.demoteHeaders(if (index == 0) 2 else 3)
+												}
 											)
 										} else {
 											// Already merged as part of an overload group. Remove this row.
-- 
2.51.2


From 097b2d59b75d0bec986777df734d390c4e5a35f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=E2=80=9CCLOVIS=E2=80=9D=20Canet?=
 <ivan.canet@gmail.com>
Date: Thu, 16 Apr 2026 20:45:09 +0200
Subject: [PATCH 2/2] feat(renderer): Hide headers level 5 and more from the
 table of contents

---
 renderer/src/jvmMain/kotlin/renderer3/Header.kt | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/renderer/src/jvmMain/kotlin/renderer3/Header.kt b/renderer/src/jvmMain/kotlin/renderer3/Header.kt
index 94c3a75..f7f5465 100644
--- a/renderer/src/jvmMain/kotlin/renderer3/Header.kt
+++ b/renderer/src/jvmMain/kotlin/renderer3/Header.kt
@@ -29,14 +29,16 @@ internal fun RenderingContext.buildHeader(
 		2 -> Decoration.ofPrefix("## ")
 		3 -> Decoration.ofPrefix("### ")
 		4 -> Decoration.ofPrefix("#### ")
-		5 -> Decoration.ofPrefix("##### ")
-
-		else -> Decoration { content ->
+		5, 6, 7 -> Decoration { content ->
 			append("**")
 			content()
 			append("**")
 			appendLine()
 		}
+		else -> Decoration { content ->
+			content()
+			appendLine()
+		}
 	}
 
 	decorator.wrapIn(writer) {