# 内容标记语法（build_docx.py）

每行一条指令，格式为 `指令|内容`；表格单元格用 `;;` 分隔，空行忽略。

| 指令 | 说明 | 示例 |
| --- | --- | --- |
| `TITLE\|` | 文档标题（居中、加粗、二号） | `TITLE\|实验报告标题` |
| `CENTER\|` | 居中段落（副标题等） | `CENTER\|——副标题` |
| `H1\|` | 一级标题（标题 1，段前分页；编号自动规范为 `1 标题`） | `H1\|1. 实验目的` |
| `H1C\|` | 居中型一级标题（参考文献/附录/致谢；标题 1 + 居中 + 段前段后0.5行 + 单倍行距） | `H1C\|6. 参考文献` |
| `H2\|` | 二级标题（标题 2） | `H2\|1.1 实验背景` |
| `H3\|` | 三级标题（标题 3） | `H3\|1.1.1 实验步骤` |
| `P\|` | 正文段落（首行缩进2字符、两端对齐、1.5倍行距、段前段后0） | `P\|这里写正文内容。` |
| `B\|` | 项目符号（正文 + 缩进） | `B\|要点一` |
| `CODE\|` | 代码行（灰底） | `CODE\|示例命令` |
| `TCAP\|` | 给**下一张表**自动编号题注（表在**上方**） | `TCAP\|实验数据` |
| `FCAP\|` | 给**下一张图**自动编号题注（图在**下方**） | `FCAP\|实验装置图` |
| `CAP\|` | 手工题注（小五黑体不加粗居中，不自动编号） | `CAP\|图 3-1 示意图` |
| `TBL\|` | 开始一张表，第一行是表头 | `TBL\|编号;;名称;;状态` |
| `ROW\|` | 表格数据行 | `ROW\|1;;步骤一;;完成` |
| `TBLW\|` | 下一张表的列宽比例（可省略，省略则等宽） | `TBLW\|1,2,4,2` |
| `IMG\|` | 插入图片：文件名 + 宽度(cm) | `IMG\|fig1.png\|14.5` |

## 内联格式
- `**文字**` 表示加粗（用于 `P` / `B` 等文本指令）。
- 字面出现的 `**`（如 `/api/**`）会被误判为加粗，应避免。

## 自动编号说明
- `TCAP|实验数据` + `TBL|...` → 表格上方生成 `表1.1 功能需求`；
- `FCAP|实验装置图` + `IMG|a.png|12` → 图片下方生成 `图1.1 实验装置图`；
- 章号取自最近一个 `H1|`/`H1C|` 的编号（如 `1. 实验目的` → 章号 1），每章内表/图序号从 1 重新开始。

## 完整示例
```
H1|1. 实验目的
H2|1.1 实验背景
P|这里写正文，支持 **加粗** 等内联格式。
B|要点一
H3|1.1.1 实验步骤
TCAP|实验数据
TBLW|1,2,2,1
TBL|编号;;项目;;内容;;备注
ROW|1;;步骤一;;采集数据;;—
FCAP|实验装置
IMG|fig.png|12.5
```