From 96359deae5e79826474dbbf3aacf79c52fb14e6b Mon Sep 17 00:00:00 2001
From: umsangdon <umsangdon@gmail.com>
Date: Mon, 26 Oct 2026 10:31:27 +0900
Subject: [PATCH] =?UTF-8?q?fix(=EA=B0=80=EC=9D=B4=EB=93=9C):=20=EA=B7=B8?=
 =?UTF-8?q?=EB=A6=BC=20=EC=84=A4=EB=AA=85=20=EC=86=8D=20=EB=8C=80=EA=B4=84?=
 =?UTF-8?q?=ED=98=B8([=EC=A0=80=EC=9E=A5]=20=EA=BC=B4)=EB=8F=84=20?=
 =?UTF-8?q?=EA=B7=B8=EB=A6=BC=EC=9C=BC=EB=A1=9C=20=EA=B7=B8=EB=A6=BC=20?=
 =?UTF-8?q?=E2=80=94=20=EA=B7=B8=EB=A6=BC=20=EC=A4=84=20=ED=92=80=EC=9D=B4?=
 =?UTF-8?q?=20=EC=A0=95=EA=B7=9C=EC=8B=9D=20=C2=B7=20=EC=8B=9C=ED=97=98=20?=
 =?UTF-8?q?=EB=8D=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 resources/tester/helper_538_help_render.cjs |  8 ++++++++
 resources/tester/test_538_help_guide.py     | 14 ++++++++++++++
 ui_template/ui_template_help.ts             |  2 +-
 3 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/resources/tester/helper_538_help_render.cjs b/resources/tester/helper_538_help_render.cjs
index f3861692c..35b9517ef 100644
--- a/resources/tester/helper_538_help_render.cjs
+++ b/resources/tester/helper_538_help_render.cjs
@@ -43,12 +43,20 @@ const DOC = [
   "![나쁜 이름](../x.webp)", // 19
   '<script>alert("x")</script>', // 20
 ].join("\n");
+// 설명 속 대괄호 — [저장] 꼴 단추 이름 · 굵게 · 링크가 섞여도 그림 줄은 그림
+const BRACKET = [
+  "![[저장] 단추 누름](b05_full.webp)", // 0
+  "![[저장]·[확정] **굵게** [글](B06/00_설명서)](b05_full.webp)", // 1
+  "[글](B06/00_설명서) 와 [저장] 문단", // 2
+  "![[저장] 뒤에 글](b05_full.webp) 덧글", // 3
+].join("\n");
 
 process.stdout.write(
   JSON.stringify({
     plain: renderHelpMarkdown(DOC),
     admin: renderHelpMarkdown(DOC, ctx(true)),
     user: renderHelpMarkdown(DOC, ctx(false)),
+    bracket: renderHelpMarkdown(BRACKET, ctx(true)),
     crlf: renderHelpMarkdown("# 가\r\n\r\n- 나\r\n- 다\r\n", ctx(false)),
   }),
 );
diff --git a/resources/tester/test_538_help_guide.py b/resources/tester/test_538_help_guide.py
index cb0db7e2c..7a81b778f 100644
--- a/resources/tester/test_538_help_guide.py
+++ b/resources/tester/test_538_help_guide.py
@@ -76,6 +76,20 @@ def test_그림_상자_링크(html) -> None:
     assert 'data-help-goto="B05/구조물_돌쌓기(메)">돌쌓기</a>' in admin
 
 
+def test_설명_속_대괄호도_그림(html) -> None:
+    out = html["bracket"]
+    src = "/api/help/B05/img/b05_full.webp?v=abc"
+    assert '<figure data-src="0-0" class="ui-help-figure" data-img="b05_full.webp">' in out
+    assert f'<img src="{src}" alt="[저장] 단추 누름" loading="lazy">' in out
+    assert "<figcaption>[저장] 단추 누름</figcaption>" in out
+    # 굵게는 캡션에서 풀리고, 링크는 그림 설명 안에서 링크로 풀리지 않음
+    assert "<figcaption>[저장]·[확정] <strong>굵게</strong> [글](B06/00_설명서)</figcaption>" in out
+    assert out.count("<figure") == 2
+    # 링크 문단은 그대로 링크 · 그림 뒤에 글이 붙은 줄은 그림이 아님
+    assert 'data-help-goto="B06/00_설명서">글</a> 와 [저장] 문단' in out
+    assert "<p" in out and "덧글" in out
+
+
 def test_html_은_먼저_막음(html) -> None:
     for out in html.values():
         assert "<script>" not in out
diff --git a/ui_template/ui_template_help.ts b/ui_template/ui_template_help.ts
index 9ae0d260f..fdc0de27d 100644
--- a/ui_template/ui_template_help.ts
+++ b/ui_template/ui_template_help.ts
@@ -161,7 +161,7 @@ export function renderHelpMarkdown(text: string, ctx?: HelpRenderContext): strin
     }
     const head = /^(#{1,4})\s+(.*)$/.exec(line);
     const item = /^(?:([-*])|\d+\.)\s+(.*)$/.exec(line);
-    const image = ctx && /^!\[([^\]]*)\]\(([^)\s]+)\)$/.exec(line);
+    const image = ctx && /^!\[(.*)\]\(([^)\s]+)\)$/.exec(line);
     if (!line) flush();
     else if (ctx && line.startsWith(">")) {
       flush();