（Python markdown tables 扩展的输出格式）。
@@ -467,16 +498,23 @@ def postprocess_table_rowspan(html):
colspan = [[1] * num_cols for _ in range(num_rows)]
# ---- 计算 rowspan（逐列扫描） ----
+ # 仅当下方单元格带 MERGE_MARKER 哨兵且内容匹配时才合并
for col in range(num_cols):
row = 0
while row < num_rows:
count = 1
r = row + 1
while r < num_rows:
- if (row_cells[r][col]["text"] == row_cells[row][col]["text"]
- and row_cells[row][col]["text"] != ""):
+ below_text = row_cells[r][col]["text"]
+ above_text = row_cells[row][col]["text"]
+ # 下方单元格必须带哨兵标记，且去除哨兵后与上方内容一致
+ if (below_text.startswith(MERGE_MARKER)
+ and below_text[len(MERGE_MARKER):] == above_text
+ and above_text != ""):
count += 1
covered[r][col] = True
+ # 将合并单元格的内容统一为去除哨兵的版本
+ row_cells[r][col]["text"] = above_text
r += 1
else:
break
@@ -494,11 +532,16 @@ def postprocess_table_rowspan(html):
count = 1
c = col + 1
while c < num_cols:
+ right_text = row_cells[row][c]["text"]
+ left_text = row_cells[row][col]["text"]
+ # 右侧单元格必须带哨兵标记，且去除哨兵后与左侧内容一致
if (not covered[row][c]
- and row_cells[row][c]["text"] == row_cells[row][col]["text"]
- and row_cells[row][col]["text"] != ""):
+ and right_text.startswith(MERGE_MARKER)
+ and right_text[len(MERGE_MARKER):] == left_text
+ and left_text != ""):
count += 1
covered[row][c] = True
+ row_cells[row][c]["text"] = left_text
c += 1
else:
break
@@ -808,6 +851,9 @@ def main():
# Markdown → HTML
chapter_html = markdown_to_html(text)
+ # KaTeX 还原（占位符 → HTML 包装的公式）
+ chapter_html = postprocess_katex(chapter_html)
+
# 图片 base64 内嵌
base_dirs = [ch_path.parent, ASSETS_DIR, PROJECT_ROOT]
chapter_html = embed_images(chapter_html, base_dirs)
diff --git a/doc_builder/renderers/render_ids.py b/doc_builder/renderers/render_ids.py
new file mode 100644
index 0000000..a45b748
--- /dev/null
+++ b/doc_builder/renderers/render_ids.py
@@ -0,0 +1,185 @@
+"""IDS 数据共享模块。
+
+提供 JSON 加载和 HTML 表格渲染函数，
+供 render_ids_acq_map / render_ids_exc_map / render_ids_daq_reg / render_ids_awg_reg 复用。
+"""
+
+import json
+from pathlib import Path
+from collections import OrderedDict
+
+# 输出顺序（先列出的模块排在前面）
+ACQ_MODULE_ORDER = ["MCU_INS", "MCU_DAT", "DAQ_REG", "DAQ_PAR", "DAQ_FLT"]
+EXC_MODULE_ORDER = ["MCU_INS", "MCU_DAT", "AWG_REG", "AWG_IDX", "AWG_WVE"]
+
+
+# ---------- 数据加载 ----------
+
+def _load_ids(filepath: str) -> dict:
+ """加载 IDS JSON 文件并返回解析后的 dict。"""
+ path = Path(filepath)
+ if not path.exists():
+ raise FileNotFoundError(f"IDS 文件不存在: {path}")
+ with open(path, "r", encoding="utf-8") as f:
+ return json.load(f)
+
+
+# ---------- HTML 工具 ----------
+
+def _td(text: str, **kwargs) -> str:
+ """生成 | 单元格，支持 rowspan / style 等属性。"""
+ attrs = " ".join(f'{k}="{v}"' for k, v in kwargs.items() if v is not None)
+ return f" | {text} | " if attrs else f"{text} | "
+
+
+def _th(text: str) -> str:
+ return f"{text} | "
+
+
+def _bit_range_str(bits: list) -> str:
+ """将 [15, 8] 或 [7] 转为位段字符串。"""
+ if len(bits) == 1:
+ return str(bits[0])
+ return f"{bits[0]}:{bits[-1]}"
+
+
+# ---------- 映射表渲染 ----------
+
+def render_mapping_acq_table(data: dict) -> str:
+ """渲染 msmt_acq 通道模块基地址表。"""
+ mi = data.get("MappingInfo", {}).get("msmt_acq", {})
+ return _render_mapping_table(mi, ACQ_MODULE_ORDER, "ACQ")
+
+
+def render_mapping_exc_table(data: dict) -> str:
+ """渲染 msmt_exc 通道模块基地址表。"""
+ mi = data.get("MappingInfo", {}).get("msmt_exc", {})
+ return _render_mapping_table(mi, EXC_MODULE_ORDER, "EXC")
+
+
+def _render_mapping_table(mapping: dict, module_order: list, label: str) -> str:
+ """通用的通道模块基地址渲染。"""
+ rows = []
+ # 收集所有模块名
+ all_modules = set()
+ for ch_info in mapping.values():
+ all_modules.update(ch_info.get("Modules", {}).keys())
+
+ # 按 module_order 排序，未在列表中的放最后
+ ordered = [m for m in module_order if m in all_modules]
+ ordered += sorted(all_modules - set(module_order))
+
+ for mod_name in ordered:
+ for ch in sorted(mapping.keys(), key=int):
+ info = mapping[ch]
+ modules = info.get("Modules", {})
+ if mod_name not in modules:
+ continue
+ m = modules[mod_name]
+ exaddr = info.get("Exaddr", "")
+ cid = info.get("Cid", "")
+ rows.append(
+ "