feat(sync): 테이블 has_column_header·has_row_header 반영 — 1행/1열 헤더 정확 렌더링 [skip-notion]

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: sungbin1015

scripts/notion_to_md.py

@@ -409,28 +409,35 @@ def render_children():
     if b_type == "table":
         if not children:
             return ""
+        tbl = block.get("table", {})
+        col_header = tbl.get("has_column_header", False)  # 1행 헤더
+        row_header = tbl.get("has_row_header", False)     # 1열 헤더
         has_color = any(
             _get_cell_bg(cell)
             for row in children
             for cell in row.get("table_row", {}).get("cells", [])
         )
-        if has_color:
+        if has_color or row_header:
             lines = ["<table>"]
+            in_tbody = False
             for i, row in enumerate(children):
                 cells = row.get("table_row", {}).get("cells", [])
-                tag = "th" if i == 0 else "td"
-                if i == 0:
+                is_col_header_row = col_header and i == 0
+                if is_col_header_row:
                     lines.append("<thead><tr>")
                 else:
-                    if i == 1:
+                    if not in_tbody:
                         lines.append("<tbody>")
+                        in_tbody = True
                     lines.append("<tr>")
-                for cell in cells:
+                for j, cell in enumerate(cells):
+                    is_th = is_col_header_row or (row_header and j == 0)
+                    tag = "th" if is_th else "td"
                     bg = _get_cell_bg(cell)
                     text = _rich_text_to_html(cell)
                     attr = f' data-notion-bg="{bg}"' if bg else ""
                     lines.append(f"<{tag}{attr}>{text}</{tag}>")
-                lines.append("</tr></thead>" if i == 0 else "</tr>")
+                lines.append("</tr></thead>" if is_col_header_row else "</tr>")
             lines.append("</tbody></table>")
             return "\n".join(lines) + "\n\n"
         lines = []
@@ -441,7 +448,7 @@ def render_children():
                 for cell in cells
             )
             lines.append(f"| {row_text} |")
-            if i == 0:
+            if i == 0 and col_header:
                 sep = " | ".join("---" for _ in cells)
                 lines.append(f"| {sep} |")
         return "\n".join(lines) + "\n\n"

scripts/tests/test_notion_to_md.py

@@ -482,3 +482,59 @@ def test_extract_text_unknown_notion_link_kept(self):
                 "href": "https://www.notion.so/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}]
         result = n.extract_text_from_rich_text(rt)
         assert result == "[외부 페이지](https://www.notion.so/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa)"
+
+
+# ── TC-12: 테이블 has_column_header / has_row_header 반영 ─────────────────────
+
+def _make_table_block(has_column_header, has_row_header, rows):
+    """rows: [["셀1", "셀2"], ...] 형태의 문자열 리스트."""
+    def _rt(text):
+        return [{"plain_text": text, "href": None,
+                 "annotations": {"bold": False, "italic": False, "strikethrough": False,
+                                 "underline": False, "code": False, "color": "default"}}]
+    children = [
+        {"type": "table_row", "table_row": {"cells": [_rt(c) for c in row]}}
+        for row in rows
+    ]
+    return (
+        {"type": "table", "table": {"has_column_header": has_column_header,
+                                    "has_row_header": has_row_header}},
+        children,
+    )
+
+
+class TestTableHeaders:
+
+    def _render(self, has_col, has_row, rows):
+        block, children = _make_table_block(has_col, has_row, rows)
+        block["_children"] = children
+        return n.block_to_markdown(block, lambda: "", lambda: 1)
+
+    def test_column_header_only_uses_plain_markdown(self):
+        """has_column_header=True만 있을 때 → plain markdown (| --- | 구분자)."""
+        out = self._render(True, False, [["헤더A", "헤더B"], ["값1", "값2"]])
+        assert "<table>" not in out
+        assert "| --- |" in out
+        assert "| 헤더A | 헤더B |" in out
+
+    def test_row_header_only_first_col_is_th(self):
+        """has_row_header=True → 1열만 <th>, 나머지 <td>."""
+        out = self._render(False, True, [["레이블1", "값1"], ["레이블2", "값2"]])
+        assert "<th>" in out
+        # 두 번째 열은 td
+        assert "<td>" in out
+        # thead 없음 (열 헤더가 없으므로)
+        assert "<thead>" not in out
+
+    def test_both_headers(self):
+        """has_column_header=True, has_row_header=True → 1행+1열 모두 <th>."""
+        out = self._render(True, True, [["구분", "A", "B"], ["X", "1", "2"]])
+        assert "<thead>" in out
+        assert "<th>" in out
+        assert "<td>" in out
+
+    def test_no_header_plain_markdown(self):
+        """헤더 없고 색 없으면 plain markdown."""
+        out = self._render(False, False, [["a", "b"], ["c", "d"]])
+        assert "<table>" not in out
+        assert "| a | b |" in out