Skip to content
Lv5AI 对话前端进度 5 / 10

第 5 章:Markdown 增量渲染 ​

流式文本永远处于"语法没写完"的状态。整段重解析会卡,直接渲染会错——要做的是"按块增量 + 容忍残缺"。


学习目标 ​

  • 说出整段重解析为什么在长回答上撑不住
  • 识别四种未闭合语法,知道它们各自会怎么错
  • 会用"块级增量"的思路组织渲染
  • 明白 XSS 防线在哪一步,以及为什么不能开 raw HTML

5.1 整段重解析的三个代价 ​

tsx
<Markdown>{text}</Markdown>   // text 每次变化都整段重解析
代价说明
CPU解析成本随文本长度线性增长,2000 字时每帧都要几百毫秒
闪烁代码块被反复销毁重建,高亮颜色会跳
状态丢失折叠的表格、复制按钮、图片加载状态每次重置

所以工业做法是:已闭合的块缓存起来,只解析"还在长的那一块"。


5.2 四种未闭合语法 ​

写到一半的 Markdown,每一种都有不同的"错相"```pydef f(): return 1没有收尾的 ```现象:整段被当代码块后文全变灰底,颜色也不对**加粗没写完*斜体也在飘`行内代码没合星号/反引号单个出现现象:页面出现裸露的 *有时整行突然变斜体| 列1 | 列2 || --- | --- || 值 | 值 |表格行数与表头不匹配现象:先显示成一行竖线文本补全后突然变成表格,高度跳动[链接](http:![图](https:URL 写了一半现象:链接不可点图片打到错误地址三种处理策略A. 容错渲染:让它先显示成纯文本,收尾后再升级成正式结构(体验最自然)B. 延后渲染:检测到"可能未闭合"就暂不渲染这一块(会有停顿感)C. 整段重解析:永远渲染"当前正确"的形态,代价是性能(5.1 已否掉)

这三种错相里,代码块最显眼:一个没闭合的 ```,后面所有内容都会掉进灰底。


5.3 选库:只做必要的事 ​

bash
npm i react-markdown remark-gfm
tsx
import ReactMarkdown from "react-markdown";
import remarkGfm from "remark-gfm";

<ReactMarkdown remarkPlugins={[remarkGfm]}>
  {text}
</ReactMarkdown>

三条原则:

  1. 不开 raw HTML(不加 rehype-raw):模型输出里的 <script> 会真的执行;
  2. GFM 必须有:表格、删除线、任务列表是对话里最常见的格式;
  3. 高亮单独处理(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,链接协议白名单

下一章 ​

界面能渲染了,接下来是"会话":消息怎么建模、多轮怎么裁、切会话怎么不串。

本文阅读--次|全站访问--次|访客--人