From b8c1508140d48c396405027e94acfe52cad3fd7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Mon, 10 Aug 2026 17:02:59 +0400
Subject: [PATCH] =?UTF-8?q?fix:=20MAN=20format=20=E2=80=94=20remove=20div?=
 =?UTF-8?q?=20markdown=3D1,=20use=20clean=20Markdown=20in=20details?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 TOOLS/docs-generator/internal/writers/writers.go | 6 ++----
 docs/30_registry/assets/extra.css                | 6 +++++-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/TOOLS/docs-generator/internal/writers/writers.go b/TOOLS/docs-generator/internal/writers/writers.go
index f99ac01..3e6cab8 100644
--- a/TOOLS/docs-generator/internal/writers/writers.go
+++ b/TOOLS/docs-generator/internal/writers/writers.go
@@ -162,11 +162,9 @@ func buildManualPage(spec types.ServiceSpec, nav string, version string) string
 	// MAN в раскрывающемся блоке — DevOps читает если застрял
 	man := strings.TrimSpace(spec.ServiceMan)
 	if man != "" {
-		b.WriteString("<details>\n<summary>Справка (MAN)</summary>\n\n")
-		b.WriteString("<div class=\"man-content\" markdown=\"1\">\n\n")
+		b.WriteString("<details class=\"man-content\">\n<summary>Справка (MAN)</summary>\n\n")
 		b.WriteString(htmlToMarkdown(man))
-		b.WriteString("\n\n</div>\n")
-		b.WriteString("</details>\n")
+		b.WriteString("\n\n</details>\n")
 	}
 	return b.String()
 }
diff --git a/docs/30_registry/assets/extra.css b/docs/30_registry/assets/extra.css
index da70810..9964276 100644
--- a/docs/30_registry/assets/extra.css
+++ b/docs/30_registry/assets/extra.css
@@ -43,11 +43,15 @@
   padding-bottom: 0.3rem;
 }
 
-.md-typeset .man-content {
+.md-typeset details.man-content {
   font-size: 0.78rem;
   line-height: 1.4;
 }
 
+.md-typeset details.man-content[open] {
+  margin-top: 0.5rem;
+}
+
 /* Resource title + tabs: compact */
 .md-typeset .md-content__inner > h1:first-child {
   font-size: 0.77rem;