# man 语义子集

|类别|已实现|局限与降级|
|---|---|---|
|元数据/章节|TH、SH、SS，标题可取下一文字或字体宏行|后续 TH 替换元数据并诊断；空标题在边界/EOF 诊断|
|段落|PP/P/LP、br、sp|sp 表示段落边界，不复现距离参数；br 保留换行|
|字体|B/I/SM/SB、BR/BI/IB/IR/RB/RI、ft、f 转义|SM/SB 只保留语义字体；没有字号排版；无参数字体宏影响下一文本行|
|定义/缩进|TP、IP、HP、RS/RE|整数 n/m 单位；不支持 RE 显式层级；IP 次级宽度参数不参与排版|
|原样块|EX/EE、nf/fi，空白行、字体宏行|不实现通用 troff no-fill 状态；结构宏打断时关闭并诊断|
|链接|UR/UE、MT/ME，末尾标点与无标签默认文本|仅 http/https/mailto/# 发射；嵌套/缺失闭合诊断|
|synopsis|SY/YS、OP|保存命令与可选参数语义，不复现 groff 页面布局|
|转义|反斜杠、连字符、不换行空格、零宽/注释、c 续行、常用字形、u 标量|s 字号被消费而不排版；字符串/寄存器不展开并诊断；未知字形保留可见转义|
|禁止|so/mso/sy/pso/open/write/de/am|Error 诊断，从不访问外部资源或执行正文|
|其他请求|默认 Warning，可设 unknown_is_error|不执行；请求行忽略，其后普通行照常解析|

普通填充文本跨行用空格连接，c 抑制下次连接空格。B/I 带多个参数以空格相连，交替字体宏拼接参数，符合常见 man 标点用法。定义项 term 单独保存，空定义正文仍保留 term。章节锚点保留 Unicode 可见字符，将 ASCII 字母转为小写并规范分隔符；冲突添加唯一后缀，空标题使用后备锚点。

HTML 保留定义、原样、章节、链接和字体结构；纯文本保留词和显式换行；Markdown 采用保守 CommonMark 表达，放弃数值布局。参考验证只覆盖仓库所列夹具；对复杂第三方手册应先审查诊断，不应假定无损转换。
