过去,我常用 https://md.doocs.org/ 这类在线工具,将 Markdown 文档粘贴进去,渲染后再复制到公众号后台。每次还要手动填写标题、作者、封面图和摘要等信息,流程繁琐且重复。其实这些元数据早已配置在 Hugo 博客的 front matter 里,手动操作不仅低效,还容易出错。随着内容量增加,这种方式越来越难以满足高效分发的需求。

因此我就想自己开发一个工具,来将我的博客一键发布到微信公众草稿。微信公众号开发接口也提供草稿发布功能,只需要配置开发者 ID(AppID) 和开发者密码 (AppSecret),另外再开启 IP 白名单即可。
你可以在 Bilibili查看一键发布的工具演示。
不过最让人头疼的还是微信公众号后台对 HTML 支持有很多特殊限制,比如:
- 代码块和表格超宽时不会自动左右滑动,导致内容溢出。
- 语法高亮只能用有限的样式,很多第三方渲染方案不兼容。
- 图片样式、外链、引用等都需要特殊处理。
- 图片需要上传到微信公众号图床再引用。
这些痛点促使我开发了自己的内部工具 wechat-markdown-exporter
,实现了博客内容一键发布到公众号草稿箱的自动化流程。这样不仅节省了大量手动操作时间,也让内容格式和样式更加统一、专业。
需要特别说明的是,这个工具目前并未开源,原因是其中耦合了很多我个人的内容处理流程和样式定制。例如,针对我的博客系统、图片引用、代码块高亮、表格滑动、内容合规检测等,都做了高度定制化,直接开源并不适合通用场景。如果你有类似需求,建议根据自己的实际情况做定制开发。
我的自动化发布架构
整体流程分为三步:
- 本地写作和内容管理(如 Hugo 博客系统,Markdown 格式规范化);
- 用自研工具自动转换和适配微信平台特殊格式(包括代码高亮、表格滑动、图片格式转换等);
- 通过微信 API 自动推送到公众号草稿箱,后台只需简单审核和发布。
发布流程实践
- 本地写作:所有内容都用 Markdown 规范编写,图片统一用图床中的图片,web 建议使用 svg 图片,在导出时需要转换为 jpg 格式,对其他 Hugo short code 需要做过滤。
- 自动转换:工具会自动将 Markdown 转为微信支持的 HTML,代码块高亮、表格超宽自动加滑动,图片自动上传并适配。
- 一键推送:内容自动同步到公众号草稿箱,后台只需简单审核即可发布。
这些问题如果靠手动处理,效率极低,体验很差。自动化工具可以统一样式、自动适配、批量推送,大幅提升内容分发效率。
我的开发心得与经验总结
开发这个工具的最大收获,是彻底解决了内容分发的效率和一致性问题。下面是一些心得分享给大家:
- 内容编写时,保持 Markdown 结构清晰,使用 markdown lint 保证 markdown 格式正确。
- 公众号不支持 svg 图片,需要对图片格式进行转换。
- 可以为你的博客增加 header 和 footer 便于在公众号中分发。
结语
从最初的手动粘贴、反复调整,到现在一键自动发布,整个内容分发流程变得高效、可靠,也让技术文章在公众号上的呈现更加专业。如果你也有类似需求,建议优先考虑自动化方案,结合自己的实际场景做定制开发。
希望这些经验能帮到更多内容创作者,有问题欢迎留言交流。