微信公众号表格转图片:为什么 HTML table 一定会窜行
微信公众号表格Playwright图文排版结论:微信不支持 <table>
微信公众号正文编辑器会在保存时剥离表格标签,把 <td> 里的内容变成连续段落,视觉上就是"窜行"。Markdown 表格转成 HTML 粘进去同理。
目前唯一稳定的解法是把表格渲染成图片,上传到微信的图片接口,再在正文里用图片引用。代价是表格内容不能被检索、不能被复制——所以只对必要表格这么做,能用列表表达的优先用列表。
实现链路
四步,全部可自动化:
- Markdown 表格 → 独立 HTML 片段(带内联样式,不依赖外部 CSS)
- Playwright 渲染该片段 → PNG(DPR 设 2 倍,保证微信里不糊)
- 调
media/uploadimg上传 → 返回url(注意不是media_id) - 把正文里的表格 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 行的表格才值得转;小表格改成列表更利于阅读和检索。