运维与数据工程笔记

微信公众号表格转图片:为什么 HTML table 一定会窜行

4 分钟
微信公众号表格Playwright图文排版

结论:微信不支持 <table>

微信公众号正文编辑器会在保存时剥离表格标签,把 <td> 里的内容变成连续段落,视觉上就是"窜行"。Markdown 表格转成 HTML 粘进去同理。

目前唯一稳定的解法是把表格渲染成图片,上传到微信的图片接口,再在正文里用图片引用。代价是表格内容不能被检索、不能被复制——所以只对必要表格这么做,能用列表表达的优先用列表。

实现链路

四步,全部可自动化:

  1. Markdown 表格 → 独立 HTML 片段(带内联样式,不依赖外部 CSS)
  2. Playwright 渲染该片段 → PNG(DPR 设 2 倍,保证微信里不糊)
  3. 调 media/uploadimg 上传 → 返回 url(注意不是 media_id)
  4. 把正文里的表格 HTML 替换为 <img src="url">
# 关键参数:按 2 倍像素密度渲染,宽度按正文栏宽
PAGE.render_to_file(html_path, png_path,
                    viewport={"width": 900, "height": 100},
                    device_scale_factor=2)

样式要点(这些细节决定成品能不能看)

项 值 原因
表头 深色背景 + 白字 微信正文背景为白,浅色表头会糊成一片
行高 按内容自适应 固定行高会截断多行单元格
斑马纹 偶数行浅灰 手机窄屏上横向对齐靠它
数字列 右对齐 + 等宽数字 便于纵向比较
外边距 0 留白由 <img> 的外层控制

字体必须显式指定中文字体栈,否则容器里没有字体时中文会变成方块:

font-family: -apple-system, "PingFang SC", "Hiragino Sans GB",
             "Microsoft YaHei", sans-serif;

三个容易翻车的点

1. 容器里没有中文字体

Playwright 在无字体环境(Alpine、精简镜像)渲染出的中文是默认替代字形或方块。要么装 fontconfig + 一款中文字体,要么在宿主机渲染。

2. 上传接口返回的是 url 不是 media_id

media/uploadimg(正文内图片)返回 {"url": "..."},而 material/add_material(永久素材)返回 media_id。用错接口会拿到空值。

3. 表格宽度超出正文栏宽

微信正文栏宽在手机上约 320–375 逻辑像素。渲染宽度设 900px 加 2 倍 DPR 是为了清晰度,但插入时要在样式里限定 width:100%,否则超宽表格会被裁切。

常见问题

能不能用富文本粘贴保留表格?

部分第三方编辑器(如秀米)支持表格,但经微信保存后仍会被降级。实测结论是不稳定,不要把排版依赖建立在第三方编辑器行为上。

图片表格会不会影响 SEO 或 AI 抓取?

会。图片里的文字对搜索引擎和 AI 爬虫是不可见的(除非有 OCR)。所以技术类长文应同时提供文字版的关键数据(哪怕只是几行摘要),图片表格只做补充。

有多少表格值得转图片?

按经验,超过 3 列或超过 8 行的表格才值得转;小表格改成列表更利于阅读和检索。