From b97edf9f578455eb9dda6f0c6712da597f2fe2bc 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:07:29 +0400
Subject: [PATCH] =?UTF-8?q?fix:=20MAN=20=E2=80=94=20use=20mkdocs-native=20?=
 =?UTF-8?q?=3F=3F=3F=20admonition,=20blank=20line=20after=20title,=20inden?=
 =?UTF-8?q?t=20all=20lines?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 TOOLS/docs-generator/internal/writers/writers.go | 11 +++++++----
 docs/30_registry/assets/extra.css                |  9 +--------
 2 files changed, 8 insertions(+), 12 deletions(-)

diff --git a/TOOLS/docs-generator/internal/writers/writers.go b/TOOLS/docs-generator/internal/writers/writers.go
index 3e6cab8..09d2f27 100644
--- a/TOOLS/docs-generator/internal/writers/writers.go
+++ b/TOOLS/docs-generator/internal/writers/writers.go
@@ -159,12 +159,15 @@ func buildManualPage(spec types.ServiceSpec, nav string, version string) string
 	}
 	b.WriteString(fmt.Sprintf("Сервис **%s** (`nubes_%s`). См. [Create params](%s_params_create.md) для списка параметров.\n\n", name, spec.Name, spec.Name))
 
-	// MAN в раскрывающемся блоке — DevOps читает если застрял
+	// MAN в раскрывающемся блоке — mkdocs-native ??? admonition
 	man := strings.TrimSpace(spec.ServiceMan)
 	if man != "" {
-		b.WriteString("<details class=\"man-content\">\n<summary>Справка (MAN)</summary>\n\n")
-		b.WriteString(htmlToMarkdown(man))
-		b.WriteString("\n\n</details>\n")
+		b.WriteString("??? note \"Справка (MAN)\"\n\n")
+		md := htmlToMarkdown(man)
+		for _, line := range strings.Split(md, "\n") {
+			b.WriteString("    " + line + "\n")
+		}
+		b.WriteString("\n")
 	}
 	return b.String()
 }
diff --git a/docs/30_registry/assets/extra.css b/docs/30_registry/assets/extra.css
index 9964276..e004c6e 100644
--- a/docs/30_registry/assets/extra.css
+++ b/docs/30_registry/assets/extra.css
@@ -43,14 +43,7 @@
   padding-bottom: 0.3rem;
 }
 
-.md-typeset details.man-content {
-  font-size: 0.78rem;
-  line-height: 1.4;
-}
-
-.md-typeset details.man-content[open] {
-  margin-top: 0.5rem;
-}
+/* MAN content inside admonition */
 
 /* Resource title + tabs: compact */
 .md-typeset .md-content__inner > h1:first-child {