Merge feat/blog-image-hoist: 리스트 이미지 자식 전체 폭 렌더 [skip-notion]

Author: sungbin1015

scripts/notion_to_md.py

@@ -402,6 +402,15 @@ def block_to_markdown(block, slug, image_counter, item_num=1):
     def render_children():
         return "".join(block_to_markdown(c, slug, image_counter) for c in children)
 
+    def render_children_hoist_images():
+        # 리스트 항목의 직속 이미지 자식은 들여쓰기하면 좁게 렌더되므로
+        # 최상위(전체 폭) 블록으로 분리한다. 문서 순서대로 렌더해 카운터 일관성 유지.
+        nested, hoisted = [], []
+        for c in children:
+            rendered = block_to_markdown(c, slug, image_counter)
+            (hoisted if c["type"] == "image" else nested).append(rendered)
+        return "".join(nested), "".join(hoisted)
+
     if b_type == "table":
         if not children:
             return ""
@@ -464,7 +473,9 @@ def render_children():
     ):  # callout은 아래 elif에서 별도 처리 — 이 tuple 포함은 rich_text 추출용
         rich_text = block[b_type].get("rich_text", [])
         content = extract_text_from_rich_text(rich_text)
-        child_md = render_children()
+        # 리스트 항목은 render_children_hoist_images()로 별도 렌더 — 여기서 렌더하면
+        # 이미지가 이중 렌더되고 image_counter가 두 번 증가한다.
+        child_md = "" if b_type in ("bulleted_list_item", "numbered_list_item") else render_children()
         if b_type == "paragraph":
             # 단일 멀티라인 인라인 코드 (`...\n...`) → fenced code block
             # CommonMark 파서가 인라인 코드 내 \n을 공백으로 치환하므로 선변환 필요
@@ -486,13 +497,13 @@ def render_children():
         elif b_type == "bulleted_list_item":
             # "2. 내용" 같이 숫자+점으로 시작하면 GFM이 nested ordered list로 파싱 — 이스케이프
             safe = re.sub(r'^(\d+)\. ', r'\1\\. ', content)
-            if child_md:
-                return f"- {safe}\n{indent_md(child_md)}\n"
-            return f"- {safe}\n\n"
+            nested, hoisted = render_children_hoist_images()
+            item = f"- {safe}\n{indent_md(nested)}\n" if nested else f"- {safe}\n\n"
+            return item + hoisted
         elif b_type == "numbered_list_item":
-            if child_md:
-                return f"{item_num}. {content}\n{indent_md(child_md, '   ')}\n"
-            return f"{item_num}. {content}\n\n"
+            nested, hoisted = render_children_hoist_images()
+            item = f"{item_num}. {content}\n{indent_md(nested, '   ')}\n" if nested else f"{item_num}. {content}\n\n"
+            return item + hoisted
         elif b_type == "to_do":
             checked = "[x]" if block["to_do"]["checked"] else "[ ]"
             return f"- {checked} {content}\n\n" + child_md

scripts/tests/test_notion_to_md.py

@@ -634,6 +634,52 @@ def test_multiple_shift_enters(self):
         assert "A  \nB  \nC" in out
 
 
+# ── 리스트 항목의 이미지 자식은 최상위(전체 폭)로 hoist ──────────────────────
+
+class TestListItemImageHoisting:
+    """Notion에서 이미지가 불릿/번호 항목의 자식으로 들어가면 들여쓰기 없이
+    최상위 블록(전체 폭)으로 렌더되어야 한다. 텍스트 자식은 기존대로 들여쓰기 유지."""
+
+    def _rt(self, text):
+        return [{"plain_text": text, "annotations": {"code": False, "bold": False, "italic": False, "strikethrough": False}, "href": None}]
+
+    def _image_child(self, url="https://notion/x.png"):
+        return {"type": "image", "id": "img-1", "image": {"file": {"url": url}}, "has_children": False}
+
+    def _list_block(self, b_type, text, children):
+        return {"type": b_type, b_type: {"rich_text": self._rt(text)}, "_children": children, "has_children": bool(children)}
+
+    @patch.object(n, "download_image", return_value="/img/blog/x/img-00.png")
+    def test_bulleted_image_child_hoisted(self, _dl):
+        block = self._list_block("bulleted_list_item", "서버에 나타난다", [self._image_child()])
+        out = n.block_to_markdown(block, "blog/x", [0])
+        img_line = next(l for l in out.splitlines() if "![image]" in l)
+        assert img_line == "![image](/img/blog/x/img-00.png)", f"이미지가 들여쓰기됨: {img_line!r}"
+        assert "- 서버에 나타난다\n\n![image](/img/blog/x/img-00.png)" in out
+
+    @patch.object(n, "download_image", return_value="/img/blog/x/img-00.png")
+    def test_numbered_image_child_hoisted(self, _dl):
+        block = self._list_block("numbered_list_item", "결과", [self._image_child()])
+        out = n.block_to_markdown(block, "blog/x", [0], 3)
+        img_line = next(l for l in out.splitlines() if "![image]" in l)
+        assert img_line == "![image](/img/blog/x/img-00.png)", f"이미지가 들여쓰기됨: {img_line!r}"
+        assert "3. 결과\n\n![image](/img/blog/x/img-00.png)" in out
+
+    def test_non_image_child_still_indented(self):
+        # 회귀: 텍스트 자식(중첩 불릿)은 여전히 2칸 들여쓰기 유지
+        child = self._list_block("bulleted_list_item", "중첩 항목", [])
+        block = self._list_block("bulleted_list_item", "부모", [child])
+        out = n.block_to_markdown(block, "blog/x", [0])
+        assert "  - 중첩 항목" in out
+
+    @patch.object(n, "download_image", return_value="/img/blog/x/img-00.png")
+    def test_image_counter_increments(self, _dl):
+        block = self._list_block("bulleted_list_item", "설명", [self._image_child()])
+        counter = [5]
+        n.block_to_markdown(block, "blog/x", counter)
+        assert counter[0] == 6
+
+
 # ── TC-14: toggle summary 인라인 마크다운 → HTML 변환 ──────────────────────────
 
 class TestToggleSummaryInlineMarkdown: