公众号排版工具全解析：开源神器与高效工作流实战指南

公众号排版这件事，做内容的朋友应该都深有体会。用微信自带的编辑器排版，样式基础、操作繁琐，尤其是写过技术文章、用过Markdown的朋友，回去用公众号原生编辑器简直就是一种折磨。好在GitHub上一直有开发者在做开源免费的排版工具，我陆陆续续试用过不少，今天挑几个真正能提升效率的聊聊，顺便把我在实际使用过程中踩过的坑和积累下来的经验一并分享出来。

1. 公众号排版工具的核心痛点与选型思路

1.1 为什么公众号自带编辑器这么难用

先说一个最根本的问题：微信公众号后台的编辑器，本质上是一个在线富文本编辑器，它在设计之初就考虑的是“能用”，而不是“好用”。我自己的体感是这几个点最让人难受：

• 样式不可复用：调整好的字号、行间距、段间距，换一篇文章就得重新来一遍，即使有“收藏样式”功能，种类也很有限，且不支持自定义CSS。
• 代码块缺失：对技术类文章极不友好。微信编辑器没有原生的代码块，只能通过第三方工具或手动改样式。即使你手动设置了背景色和等宽字体，在手机上显示也经常错位。
• 图片处理能力弱：不能直接调整图片圆角、阴影，更不用说批量处理了。
• 复制格式错乱：从Word、网页或其他编辑器复制内容到公众号后台，格式大概率会乱掉，需要手动清理，非常浪费时间。

所以，我从很早开始就形成了自己的排版原则：不在公众号后台写字，更不在后台排版。我的工作流是“本地写、工具排、一键粘贴”。这个工作流的最后一环，也就是“排版”，就是GitHub上这些开源工具要解决的问题。

1.2 开源排版工具的整体方案分类

我试用过的所有公众号排版工具，可以分成三类，了解了这个分类，你就不容易在众多项目里挑花眼：

第一类：Markdown本地预览转换型

代表作是md2all这类工具。它们提供的其实是一个本地网页编辑器，你在左侧用Markdown语法写作，右侧实时预览公众号文章效果，排好后一键复制到公众号后台。这类工具的好处是：完全离线可用，速度极快，数据不出本地。缺点是需要自己手动启动服务或者打开本地HTML文件，写作和复制是两个独立动作，整体“仪式感”比较强。

第二类：在线服务型

代表作是Doocs/md、WeChat Format等。它们属于在线网站，开箱即用，浏览器打开就能写。这类工具的优势是跨平台、无需部署、样式丰富，还能保存配置。但问题在于，在线服务依赖服务器稳定，万一项目维护者停止维护，或者服务器过期，工具就不能用了。

第三类：浏览器插件或编辑器插件型

代表作有Markdown Editor for WeChat、各种VS Code插件。它们是寄生在现有编辑器（如VS Code、Typora）里的插件，你在自己熟悉的编辑器里写文章，用插件自带的命令或快捷键一键转换成公众号格式并复制到剪贴板。这类工具的最大好处是“写作与排版一体化”，我最终主力使用的方案就是这种。

三类方案各有优劣，具体选择取决于你是“重排版”还是“重写作”。如果你对排版要求很高，喜欢细腻的样式控制，第一类和第二类更合适；如果像我们这种写技术博客出身的，习惯在代码编辑器里写字，那第三类才是最终归宿。

1.3 选型时我考察的几个关键维度

在深度使用之前，我给自己定了一些选型的判断标准，这里分享出来，供大家参考：

• 代码维护活跃度：直接看GitHub仓库的最后提交时间。超过半年没更新的项目，原则上直接排除，因为公众号后台的HTML结构偶尔会变，长期不维护的工具迟早会失效。
• 样式简约程度：我个人的审美偏简约，工具默认样式如果花里胡哨（比如大量彩色边框、渐变背景、卡通分割线），基本直接淘汰。因为这类样式在编辑器里看着还行，出了文章正文，跟整体品牌调性很难统一。
• 是否支持自定义CSS：这是一个分水岭。不能自定义CSS的工具，意味着你只能用它预置的皮肤，无法形成自己的排版风格。能调CSS的，你就能完全掌控文章的视觉呈现。
• 扩展能力：比如是否支持图片上传到图床、是否支持自定义代码高亮主题、是否支持字数统计等。这些辅助能力能省下不少时间。

2. 主流开源工具的对比分析与实测体验

2.1 工具A：md2all

md2all是我最早使用的一批工具之一。它是一个项目地址在github.com/yangweigbh/md2all的本地工具，不需要联网，整个工具就是一个HTML文件。

实测体验：

首次使用需要有一些耐心，因为你需要自己用浏览器打开index.html文件。打开后的界面很“朴素”，左侧是Markdown编辑区，右侧是公众号样式预览区。你写完左侧内容，右侧会实时渲染。

这款工具的亮点在于它内置了几套还算耐看的主题，比如“绿意”、“清雅”等，并且支持调整字体、字号、行间距、代码块样式。它还提供了“复制到公众号”按钮，一键就能把格式化好的内容复制到剪贴板。

存在的问题：

• 界面语言是英文居多，对有些朋友不太友好。
• 样式虽然可以改，但CSS修改的入口藏得比较深，对不熟悉前端的朋友来说有一定门槛。
• 图片处理相对简单，虽然有“本地图片转Base64”功能，但处理大图时粘贴到公众号后台容易超出字符限制。

适合人群：喜欢折腾、有一定技术基础、追求完全离线的用户。

2.2 工具B：Doocs/md

Doocs/md是后来社区热度非常高的一个开源项目，仓库地址是github.com/doocs/md。它提供了在线预览的Web版本，也支持Docker私有化部署。

实测体验：

Doocs/md的界面现代化程度比md2all高出不少，左侧编辑区，右侧预览区，样式干净。它最大的特点是“主题丰富”，内置了多套主流配色，基本上你看到的很多公众号大V的排版风格，在它的主题库里都能找到影子。

它有一个功能让我印象很深：一键复制整个公众号文章内容。你写完文章后点复制，粘贴到公众号后台时，不仅正文格式正确，连标题、摘要、作者等元信息的占位符都能一起复制进去，省了很多重复劳动。

它还支持同步文章到多个平台（如掘金、博客园、CSDN等）。如果你的内容是多平台分发的，这个功能非常实用。

存在的问题：

• 在线版本偶尔会有网络延迟，打开慢。
• 免费版本有一些高级主题不支持，需要自己部署才能解锁。
• 因为项目太热门，在线网站的访问量很大，偶尔会碰到服务不稳定的情况。

适合人群：追求开箱即用、喜欢丰富主题、有多平台分发需求的创作者。

2.3 工具C：WeChat Format

WeChat Format是一款VS Code插件，仓库地址在github.com/lyricat/wechat-format。它也是我目前主力在使用的一个方案。

实测体验：

安装方式非常简单，在VS Code扩展市场搜索“wechat-format”安装即可。使用的时候，只需要在写好的Markdown文件里点击右键，选择“一键排版”命令。插件会自动将当前文档转化成公众号风格的HTML，并复制到剪贴板。你再回到公众号后台粘贴即可。

它的内置样式比较克制，没有太多花哨的元素，整体走的是干净、清晰的路线。代码高亮使用highlight.js，支持大多数主流代码风格。最让我喜欢的是它的“图片外链自动转Base64”功能。因为公众号后台无法直接使用外链图片，如果你文章中引用了远程服务器上的图片，粘贴到后台会裂掉。这个插件在复制前会检测外链图片并自动转成Base64嵌入，虽然会让HTML文件变大，但至少保证了图片不会丢。

存在的问题：

• 高度依赖VS Code，如果你不用VS Code就白搭。
• 默认样式不够丰富，如果你想换皮肤，需要手动修改插件的CSS文件，对CSS不熟的朋友有点难。
• 它只负责“转换并复制”，不提供预览界面，所以你把内容粘贴到公众号后台前，看不到最终的渲染效果。不过这一点我基本可以接受，因为熟练后对样式心里有数。

适合人群：VS Code重度用户、技术文章写作者、追求写作与排版一体化的人。

2.4 工具D：Thesecretary / Markdown-Nice之流

除了上面三个，还有一些偏门但好用的小工具，比如“Thesecretary（开源秘书）”，它是一个Obsidian插件，专门针对Obsidian笔记软件用户设计。因为Obsidian本身就是一个Markdown编辑器，配套这个插件后，写完笔记一键就能转成公众号文章，非常顺滑。如果你在用Obsidian管理自己的内容库，这是一个不容错过的小众神器。

还有“Markdown-Nice”，曾经也很火，现在因为维护力度下降，我在实际使用中发现它偶尔会有渲染上的小问题，所以逐渐不再作为主力推荐。

2.5 工具横向对比总表

3. 实操过程与核心环节实现

3.1 快速体验方案：使用Doocs/md在线版

如果你只是想快速体验一下（不折腾本地环境），那我建议你直接用Doocs/md的在线版。它的官方地址是md.doocs.org。打开之后，整个界面是中文的，上手成本极低。

实操步骤：

1. 在左侧编辑器区域用Markdown语法写好内容。
2. 在右侧预览区确认显示效果。
3. 点击顶部的“主题”按钮，浏览内置主题，选择一个自己看着舒服的。
4. 点击“复制”按钮，然后打开公众号后台新建图文，在正文区域直接粘贴即可。

我在实际操作中发现一个细节：Doocs/md默认主题的代码块在手机端的字体大小偏小，如果想调整，可以在它的源码里修改默认字体大小参数。如果你是在线版本，无法改源码，那就只能在微信公众号后台再手动选中代码块调整一遍字号。

3.2 进阶方案：部署自己的Doocs/md实例

在线版本虽然方便，但如果你对数据隐私有要求，或者希望自定义主题，就需要自己部署一套。不用担心，部署难度不大，我实测过两种方式。

方式一：使用Docker部署（推荐）

确保你的机器安装了Docker，然后执行以下命令：

docker run -d --name doocs-md -p 8080:80 doocs/md:latest

等待容器启动后，浏览器访问http://localhost:8080即可使用。

这里如果想正式使用，建议用-v参数挂载一个数据卷，把配置文件放出来，方便后续升级不丢配置。

方式二：手动下载源码部署

git clone https://github.com/doocs/md.git cd md npm install npm run dev

本地开发环境启动后，默认访问http://localhost:3000。生产构建用npm run build，构建产物在dist目录下，扔到任意静态服务器就能跑。

我个人建议，如果你只是自己用，Docker方案最省心；如果你想深度定制UI，就需要源码方式。

3.3 主力方案：VS Code + WeChat Format 配合使用

作为一个VS Code重度用户，我最终长期用的是这套组合拳。下面详细讲讲我的配置流程。

第一步：安装插件

打开VS Code，在扩展市场搜索“wechat-format”，找到插件后点击安装。

第二步：调整插件样式（关键步骤）

插件默认的字体是14px，行间距也不算大，我实测在公众号后台看会略显拥挤。所以我一般会修改插件的CSS文件。

先在VS Code的设置里找到wechat-format.editorFontSize，把它改成16px。然后找到wechat-format.lineHeight，调成1.8。这两项在插件设置面板里都能直接看到解释说明，不需要改代码。

如果你需要完全自定义，也可以直接修改插件的style.js文件。方法是：安装好插件后，在VS Code的扩展文件夹里找到wechat-format，打开src/style.js，里面就是全局CSS字符串。你可以把.wechat-format类下面的font-size、line-height、color等参数都改成自己的偏好值。

我自己的经验是，公众号文章的字号在15px到16px之间最合适，行间距1.7到1.8，段间距0.5em以上，这样的长文阅读体验最好。

第三步：写作和排版

在VS Code里打开你的Markdown文件，写完内容后，在编辑器任意位置点击右键，选择“一键排版”。此时插件会自动做三件事：

1. 将Markdown转换为带公众号样式的HTML。
2. 将外链图片自动转成Base64格式。
3. 将转换好的HTML复制到剪贴板。

回到公众号后台，直接粘贴即可。整个过程不超过5秒。

第四步：处理代码块和图片

代码块通常占版面较大，如果代码行数很多，在手机上显示体验并不好。我的习惯是，在公众号后台粘贴完成后，手动检查一下代码块部分，尤其是长代码，我会把代码块折叠成一行或者手动截图上传。这个动作虽然多一步，但能显著提升阅读体验。

3.4 自定义主题的思路（以WeChat Format为例）

聊点进阶内容。很多朋友问我“如何让自己的公众号排版看起来特别一点”，我的答案永远是“自己做一套样式”。

以WeChat Format为例，它在src/style.js里定义了一个大字符串变量，所有样式都在这里面。你完全可以自己写一套CSS，做到和别人完全不一样的视觉效果。

比如，我给自己博客配的样式是这样的思路：

• 正文文字颜色不用纯黑，用#3f3f3f，观感更柔和。
• 标题用品牌色#007AFF，加粗但不加大太多。
• 引用块用左边框线加浅灰背景，不用花哨的底色。
• 代码块用深色背景、浅色文字，代码字体用JetBrains Mono或Consolas。

改成自己的样式后，每次排版复制出来的就是你的专属风格，读者一眼就能认出你的文章。这个优势是在线工具无法比拟的。

4. 常见问题与排查技巧实录

4.1 复制粘贴到公众号后代码块没有高亮

这是我被问得最多的问题。原因是WeChat Format这类插件在复制后会使用highlight.js生成代码高亮的HTML结构，但公众号后台编辑器会过滤掉大部分class属性，导致颜色样式丢失。

解决办法：在公众号后台粘贴后，选中代码块区域，看顶部的工具栏是否出现了“代码块”相关的处理按钮。如果没有，手动给代码块文字加一个背景色，或者单独用截图工具把代码区域截图后插入图片。这是我目前最稳定的做法。

4.2 图片粘贴后显示异常

公众号后台对复制过去的Base64图片，正常情况下是支持的。但如果你一篇文章中有大量高清大图，Base64后的字符数量会很大，这时候粘贴到后台可能出现上传失败或者内容过长无法保存的情况。

解决办法：尽量压缩图片再插入文章；或者先用图床服务（如七牛云、阿里云OSS）上传图片，再在Markdown里用外链方式引用。但是要注意，外链图片在公众号后台保存后通常会失效，所以要么用Base64，要么就直接在公众号后台手动上传图片。

4.3 在线版工具打不开或非常慢

Doocs/md免费在线版时常会因为流量高峰而变慢，这时候不要着急，可以先检查本地网络，如果没问题再考虑用Docker方式自己部署一份。部署之后不仅速度飞快，还能解锁全部高级主题。

4.4 格式化后排版在手机上错位

很多朋友在电脑上看着好好的，一用手机预览就乱了。最典型的是表格排版。公众号后台对表格的兼容性非常差，它会强制每个单元格自动换行，导致表格变形。

解决办法：尽量避免在公众号文章中使用复杂表格。如果要展示二维数据，建议用截图的方式把表格做成图片，稳稳当当。如果你确实需要实时更新的数据表格，建议用简单的一维列表代替。

4.5 自定义CSS后工具升级被覆盖

很多朋友遇到过这种情况：辛苦修改的样式，因为插件升级被重置了。这个问题的根源在于升级的时候，旧配置被新安装包覆盖了。

解决办法：在修改样式文件之前，先把原始文件复制一份到本地，比如存到你的笔记软件里。升级后如果需要重新修改，对照旧配置再改一遍就行。还有一个更好的办法：使用支持“自定义CSS路径”的工具。比如我目前在用的WeChat Format新版，它支持在设置里指定一个外部CSS文件路径，插件在加载时会优先读取这个外部文件。这样一来，样式跟插件本体就解耦了，升级随便升，样式永远都在。

4.6 工具体验总结表

5. 后续可以扩展的方向

这套排版工作流稳定用了一段时间后，我开始琢磨怎么让内容产出效率再高一点。目前比较可行的扩展方向有这么几个：

第一个方向是把排版工具接入自动化发布流程。比如利用GitHub Actions，在你推送到仓库时自动将Markdown文章构建成公众号格式的HTML，并自动上传素材到草稿箱。虽然微信目前没有官方开放“发布文章”接口，但部分第三方平台已经能实现半自动化操作了。

第二个方向是样式组件化。不要满足于一篇文章的排版，可以把常用模块（比如提示框、代码块、待办列表）做成一套组件，需要的时候像搭积木一样组合。这个思路也可以用在你自己的个人网站或双平台分发上，保持所有平台视觉一致。

第三个方向是把公众号排版和你的个人知识库打通。我现在的文章产出路径是：先写进Obsidian做积累，再复制到VS Code排版，最后粘贴到公众号。如果你能把Obsidian、VS Code和公众号后台三者之间的切换做到一键完成，就省掉了大量重复的复制粘贴动作。这也是我一直想进一步优化的方向。

公众号排版工具的生态，在GitHub上一直都很活跃。我上面提到的这些方案，只是众多优秀项目中的一小部分，如果你有自己私藏的神器，欢迎在评论区留言分享。毕竟，工具是死的，生产效率是活的，一套顺手的排版流程，真的能让写作这件事愉快很多。