KaTeX 公式渲染

问题：公式展示的两个痛点

在提成说明、报价计价规则这类业务页面里，经常会出现类似 基数 × 提点 的表达式。直接写成纯文本，对账时容易看不清小数位和括号层级；做成图片上传，又带来维护成本和远程服务的不稳定性。更麻烦的是，这类页面往往需要打印留档，图片在黑白打印时可能糊成一团。

技能如何工作

公式渲染技能基于 KaTeX 在本地完成排版，不依赖远程 LaTeX 渲染服务。核心流程是：

• 安装 katex 及官方 CSS，封装一个 renderShareFormula 方法
• 将方法挂载到报告卡片组件上，公式以 KaTeX 渲染输出
• 在打印场景下，确认 CSS 已打包进样式或打印模板，保证纸质输出的可读性

自测时可用 20% / 4% 这类实际数值验证渲染正确性。

适用边界与注意点

输入安全是硬约束。 公式字符串必须来自可信配置或经过转义的业务模板。未消毒的用户输入直接当 HTML 插入会带来 XSS 风险。

建议在界面上提供源码/渲染切换或旁注，方便对账人员核对原始公式表达式。渲染失败时给出中文提示而非白屏，降低排查成本。

需要留意的是，KaTeX 覆盖的是 LaTeX 的常用子集。如果项目中涉及特殊宏或复杂排版，可能需要预先验证兼容性。