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 {