公众号排版:为什么 Markdown 粘过去就乱了

本地用 Markdown 写得整整齐齐,粘到公众号后台一看:列表变成了没有缩进的段落,代码块被硬折行折成狗牙,图片全裂,链接点不动。

大多数人第一反应是"排版工具没选对",其实是没搞清一件事:公众号的正文编辑器不是浏览器,它会过滤 HTML。你写的样式,大部分根本到不了读者眼前。

公众号排版:Markdown 到微信的那一步
图 1:排版工具解决的从来不是审美问题,是兼容性问题

一、四个卡点,决定了所有排版工具的设计

从 Markdown 到公众号掉了四样东西
图 2:四个卡点,决定了为什么必须把样式内联

① 只保留内联样式

公众号会删掉 <style> 标签、外链 CSS、@media 查询和大部分伪类。也就是说:你在 Markdown 预览页看到的样式,必须在每个元素上写成 style="..." 才留得住。

这就是为什么所有排版工具的"转换"其实只做一件事:把 CSS 类展开、内联到每个标签上。

② class 和 id 会被过滤

靠类名写主题在公众号里行不通。你写的 .title{font-size:20px},粘过去类名还在、样式没了,标题就跟正文一样大。

③ 图片必须进素材库

正文里放一个外部图片地址,读者看到的是裂图——公众号不会替你代理外链图片。所以工具要么让你手动上传,要么走接口先传到素材库再取微信的地址。

④ 正文里的站外链接不可点

这一条最容易被忽略:公众号图文正文中的外部链接默认不可点击。想让读者跳到站外,只有两个位置——文末的「阅读原文」,或者公众号菜单/自动回复里的链接。正文里写 https://xxx 只能是一串文字。

二、四个开源排版工具,怎么选

四个开源排版工具与一套排版参数
图 3:星数与协议为核对值,停更的也列出来,因为很多老教程还在引用它
  • doocs/md(13,554 星,WTFPL,仍在活跃更新):目前用得最多的一款,主题多、代码高亮和脚注都齐,支持自定义 CSS 变量。缺点是个别主题为了好看牺牲了移动端可读性。
  • mdnice(4,682 星,GPL-3.0,2023 年停更):主题设计是最漂亮的一批,很多老教程还在推它。但依赖的旧版本库已经不更新,粘新版 Markdown 语法可能出问题。
  • wechat-format(4,559 星,仓库里没有 LICENSE 文件,2025 年还有提交):最早一批做这件事的工具,纯前端、体积极小,适合自己部署一份在内网用。没协议意味着商用前要先问作者。
  • 文颜 wenyan(1,097 星,Apache-2.0,活跃):桌面端工具,一次写好可以同时导出公众号、头条、知乎三种格式,适合多平台分发的人。

选型只看一件事:你还打算自己改样式吗。不改就选主题最多的,改就选支持自定义 CSS 变量的。

三、一套照抄就不会难看的参数

见上图右下角,逐条解释为什么是这些数:

  • 正文 15–16px:微信正文默认 17px 偏大,15–16px 在一屏里能放下更多行,长文的阅读节奏明显更好;
  • 行高 1.7–1.8:中文没有词间空格,行高低于 1.6 会挤成一片;
  • 段间距 1.5em:比行高大一档,段落才有呼吸感;
  • 图片宽度 100%:不要设置具体像素宽度,手机屏幕宽度不固定,写死就会溢出或留白;
  • 代码块横向滚动:公众号对 <pre> 的换行处理很不友好,必须给容器加 overflow-x:auto,否则长行会被硬折;
  • 主色只用 1 个:标题、加粗、引用线全用一个颜色,多了就变成"花"。

四、五个立刻能改善观感的细节

  1. 三级标题够用了:一篇三千字的文章,H2 + H3 已经是极限,H4 在手机上跟正文没区别;
  2. 每 300–400 字插一个视觉断点:小标题、图、引用块、分隔线,任选其一。没有断点的长文,跳出率一定高;
  3. 引用块别用来放重点:引用块的语义是"别人的话",你自己的重点应该用加粗,混用会让读者误以为是引述;
  4. 图片统一比例:3:2 或 16:9 选一个用到底,混着放会让整篇的节奏像拼贴;
  5. 行内代码只标命令和字段:满屏灰底会破坏阅读流,只有真正需要"原样复制"的内容才用。

五、外链怎么放才不浪费

前面说了,正文外链点不动。所以外链只有三个有效位置,按转化效果排序:

  1. 阅读原文:唯一能跳站外的入口,一篇文章只能放一个,所以要挑最值得导流的那一篇;
  2. 公众号内链:链到自己历史文章是可点的,适合做系列文的互相导流;
  3. 菜单与自动回复:把入口做在菜单里,读者随时能点,不依赖某一篇文章。

如果只是想给读者一个"官方说明书"的出处,把地址写成文字放在文末即可,比如公众号的后台在 mp.weixin.qq.com,开放接口文档在 developers.weixin.qq.com/doc——这两处是权威出处,读者自己搜也一样能找到。

六、想自动化发布,接口这条路是通的

如果一周要发十几篇,手工复制粘贴迟早出错。公众号提供了发布接口,流程是固定的三步:

  1. 传素材:正文里的图片先上传,拿到微信自己的图片地址,再用这个地址拼正文;
  2. 建草稿:把标题、作者、正文 HTML、封面图提交成草稿;
  3. 发布:从草稿发布成正式图文,或者提交群发。

三个坑要提前知道:access_token 有有效期且调用次数有限,必须做全局缓存和失效重取;正文里的图片必须先传素材库,直接填外链一定裂;草稿接口对 HTML 的过滤比编辑器更严,本地预览通过不代表接口能过。

接口怎么调、消息怎么加解密,站里已经写过两篇:公众号服务器配置与消息加解密、公众号网页授权 OAuth2.0。如果只是想把已发布的文章归档下来,公众号文章批量下载与离线归档更实用。

七、自查清单

  1. 粘到草稿箱后,在手机上预览过一遍——不是只看电脑端;
  2. 正文里的每一张图,都确认是微信自己的地址;
  3. 代码块在手机上能横向滚动,没有被硬折行;
  4. 「阅读原文」填了,而且指向最该导流的那一篇;
  5. 整篇只用了一个主色,标题层级没有超过三级。

五条里第一条最容易被跳过,也最容易出问题:公众号后台的电脑预览和手机实际渲染,差别比想象中大。

八、一句话总结

公众号排版的难点不在审美,在兼容——样式要内联、图片要进素材库、外链要换个位置放。把这三个限制搞清楚,随便挑一个开源工具都能排出能看的东西;搞不清楚,用再贵的编辑器也一样乱。

相关阅读

← 上一篇 手机号校验这件小事:E.164、国家码和「这个号码真的存在吗」

评论

访问统计