第 5 章:Markdown 增量渲染
流式文本永远处于"语法没写完"的状态。整段重解析会卡,直接渲染会错——要做的是"按块增量 + 容忍残缺"。
学习目标
- 说出整段重解析为什么在长回答上撑不住
- 识别四种未闭合语法,知道它们各自会怎么错
- 会用"块级增量"的思路组织渲染
- 明白 XSS 防线在哪一步,以及为什么不能开 raw HTML
5.1 整段重解析的三个代价
tsx
<Markdown>{text}</Markdown> // text 每次变化都整段重解析| 代价 | 说明 |
|---|---|
| CPU | 解析成本随文本长度线性增长,2000 字时每帧都要几百毫秒 |
| 闪烁 | 代码块被反复销毁重建,高亮颜色会跳 |
| 状态丢失 | 折叠的表格、复制按钮、图片加载状态每次重置 |
所以工业做法是:已闭合的块缓存起来,只解析"还在长的那一块"。
5.2 四种未闭合语法
这三种错相里,代码块最显眼:一个没闭合的 ```,后面所有内容都会掉进灰底。
5.3 选库:只做必要的事
bash
npm i react-markdown remark-gfmtsx
import ReactMarkdown from "react-markdown";
import remarkGfm from "remark-gfm";
<ReactMarkdown remarkPlugins={[remarkGfm]}>
{text}
</ReactMarkdown>三条原则:
- 不开 raw HTML(不加
rehype-raw):模型输出里的<script>会真的执行; - GFM 必须有:表格、删除线、任务列表是对话里最常见的格式;
- 高亮单独处理(5.5),不要塞进主渲染流程。
5.4 块级增量
核心思路:把文本按"空行"切成块,只重解析最后一块。
块1(已闭合,缓存 HTML) → 不变
块2(已闭合,缓存 HTML) → 不变
块3(正在增长,每帧解析) → 每次重解析ts
function splitBlocks(text: string) {
const blocks = text.split(/\n{2,}/);
const tail = blocks.pop() ?? ""; // 最后一块不稳定
return { stable: blocks, tail };
}两个细节:
- 代码块跨空行:三引号代码块内部也有空行,按空行切会切错。所以切块前要"标记代码块区间,整段视为一块";
- 列表跨空行:
- a与- b之间有空行时会被切成两块,渲染会丢列表结构。稳妥做法是只在"确定闭合"的块上缓存,最后两块都重解析。
5.5 代码高亮:等闭合再上色
tsx
// 未闭合:先当纯文本,保证可读
if (!isClosed(text)) return <pre className="code-plain">{code}</pre>;
// 闭合后:异步高亮,高亮结果缓存在 ref
const html = await highlight(code, lang);原因:高亮器对残缺代码经常抛错或给出混乱结果,而且高亮是异步的,每帧都跑一次会排队堆积。
一个折中:未闭合时用"等宽 + 浅灰底"呈现,闭合瞬间替换为高亮版——用户感知是"代码变漂亮了",不是"闪了一下"。
5.6 XSS:防线在哪
| 位置 | 风险 | 防线 |
|---|---|---|
| 模型输出的 HTML | 直接执行脚本 | 不开 rehype-raw,HTML 一律当文本 |
| 模型输出的链接 | javascript: 协议 | 渲染前校验 href 协议白名单 |
| 图片地址 | 内网地址探测、追踪像素 | 图片走代理或域名白名单 |
| 复制按钮 | 剪贴板注入 | 只复制纯文本,不复制 HTML |
链接校验的最小实现:
ts
const SAFE = /^(https?:|mailto:|#|\/)/i;
function safeHref(href?: string) {
return href && SAFE.test(href) ? href : "#";
}5.7 一个可用的最小实现
tsx
function AssistantMessage({ text, streaming }: { text: string; streaming: boolean }) {
const { stable, tail } = useMemo(() => splitBlocks(text), [text]);
const stableHtml = useStableCache(stable); // 只解析新增的块
return (
<div className="prose">
{stableHtml.map((h, i) => (
<div key={i} dangerouslySetInnerHTML={{ __html: h }} />
))}
<ReactMarkdown remarkPlugins={[remarkGfm]}>{tail}</ReactMarkdown>
{streaming && <span className="caret" />}
</div>
);
}
dangerouslySetInnerHTML只用于自己解析并清洗过的缓存结果,不要拿它渲染模型原文。
本章小结
| 要点 | 说明 |
|---|---|
| 整段重解析 | 长文本下 CPU、闪烁、状态丢失三连 |
| 四种残缺 | 代码块、强调、表格、链接 |
| 增量思路 | 按块切,已闭合缓存,只重解析尾部 |
| 切块陷阱 | 代码块与列表跨空行,别盲目切 |
| 高亮 | 闭合后再做,未闭合给等宽纯文本 |
| 安全 | 不开 raw HTML,链接协议白名单 |
下一章
界面能渲染了,接下来是"会话":消息怎么建模、多轮怎么裁、切会话怎么不串。