公众号排版:为什么 Markdown 粘过去就乱了
本地用 Markdown 写得整整齐齐,粘到公众号后台一看:列表变成了没有缩进的段落,代码块被硬折行折成狗牙,图片全裂,链接点不动。
大多数人第一反应是"排版工具没选对",其实是没搞清一件事:公众号的正文编辑器不是浏览器,它会过滤 HTML。你写的样式,大部分根本到不了读者眼前。
一、四个卡点,决定了所有排版工具的设计
① 只保留内联样式
公众号会删掉 <style> 标签、外链 CSS、@media 查询和大部分伪类。也就是说:你在 Markdown 预览页看到的样式,必须在每个元素上写成 style="..." 才留得住。
这就是为什么所有排版工具的"转换"其实只做一件事:把 CSS 类展开、内联到每个标签上。
② class 和 id 会被过滤
靠类名写主题在公众号里行不通。你写的 .title{font-size:20px},粘过去类名还在、样式没了,标题就跟正文一样大。
③ 图片必须进素材库
正文里放一个外部图片地址,读者看到的是裂图——公众号不会替你代理外链图片。所以工具要么让你手动上传,要么走接口先传到素材库再取微信的地址。
④ 正文里的站外链接不可点
这一条最容易被忽略:公众号图文正文中的外部链接默认不可点击。想让读者跳到站外,只有两个位置——文末的「阅读原文」,或者公众号菜单/自动回复里的链接。正文里写 https://xxx 只能是一串文字。
二、四个开源排版工具,怎么选
- 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 个:标题、加粗、引用线全用一个颜色,多了就变成"花"。
四、五个立刻能改善观感的细节
- 三级标题够用了:一篇三千字的文章,H2 + H3 已经是极限,H4 在手机上跟正文没区别;
- 每 300–400 字插一个视觉断点:小标题、图、引用块、分隔线,任选其一。没有断点的长文,跳出率一定高;
- 引用块别用来放重点:引用块的语义是"别人的话",你自己的重点应该用加粗,混用会让读者误以为是引述;
- 图片统一比例:3:2 或 16:9 选一个用到底,混着放会让整篇的节奏像拼贴;
- 行内代码只标命令和字段:满屏灰底会破坏阅读流,只有真正需要"原样复制"的内容才用。
五、外链怎么放才不浪费
前面说了,正文外链点不动。所以外链只有三个有效位置,按转化效果排序:
- 阅读原文:唯一能跳站外的入口,一篇文章只能放一个,所以要挑最值得导流的那一篇;
- 公众号内链:链到自己历史文章是可点的,适合做系列文的互相导流;
- 菜单与自动回复:把入口做在菜单里,读者随时能点,不依赖某一篇文章。
如果只是想给读者一个"官方说明书"的出处,把地址写成文字放在文末即可,比如公众号的后台在 mp.weixin.qq.com,开放接口文档在 developers.weixin.qq.com/doc——这两处是权威出处,读者自己搜也一样能找到。
六、想自动化发布,接口这条路是通的
如果一周要发十几篇,手工复制粘贴迟早出错。公众号提供了发布接口,流程是固定的三步:
- 传素材:正文里的图片先上传,拿到微信自己的图片地址,再用这个地址拼正文;
- 建草稿:把标题、作者、正文 HTML、封面图提交成草稿;
- 发布:从草稿发布成正式图文,或者提交群发。
三个坑要提前知道:access_token 有有效期且调用次数有限,必须做全局缓存和失效重取;正文里的图片必须先传素材库,直接填外链一定裂;草稿接口对 HTML 的过滤比编辑器更严,本地预览通过不代表接口能过。
接口怎么调、消息怎么加解密,站里已经写过两篇:公众号服务器配置与消息加解密、公众号网页授权 OAuth2.0。如果只是想把已发布的文章归档下来,公众号文章批量下载与离线归档更实用。
七、自查清单
- 粘到草稿箱后,在手机上预览过一遍——不是只看电脑端;
- 正文里的每一张图,都确认是微信自己的地址;
- 代码块在手机上能横向滚动,没有被硬折行;
- 「阅读原文」填了,而且指向最该导流的那一篇;
- 整篇只用了一个主色,标题层级没有超过三级。
五条里第一条最容易被跳过,也最容易出问题:公众号后台的电脑预览和手机实际渲染,差别比想象中大。
八、一句话总结
公众号排版的难点不在审美,在兼容——样式要内联、图片要进素材库、外链要换个位置放。把这三个限制搞清楚,随便挑一个开源工具都能排出能看的东西;搞不清楚,用再贵的编辑器也一样乱。






评论