| name | publish-to-wechat |
| description | Use this skill when the user wants to publish Markdown content to WeChat Official Account (微信公众号). This includes converting Markdown to WeChat-compatible format, formatting articles for mobile reading, and publishing to the official account platform. |
| license | MIT |
微信公众号发布指南
Overview
本指南帮助你将 Markdown 文档转换为微信公众号兼容的格式,并发布到公众号。
快速开始
推荐方案:Doocs/md 编辑器(免费无需注册)
cat your-article.md | pbcopy
open https://doocs.github.io/md/
操作步骤:
- 在左侧编辑区粘贴 Markdown 内容
- 右侧实时预览效果
- 点击右上角 「复制」 按钮
- 打开公众号后台 → 内容与互动 → 图文消息 → 写新图文
- 在正文区域 Cmd+V 粘贴即可
发布前优化
排版建议
- 精简标题:公众号标题限制 64 字符,建议简洁有力
- 使用 Emoji:适当添加 emoji 增加阅读趣味 🎯
- 移除徽章图片:公众号对外链图片支持有限,建议用文字替代
- 优化表格:确保表格在移动端可正常滚动查看
- 检查图片:确保图片已上传到图床,公众号不支持相对路径
标题风格示例
| 风格 | 示例 |
|---|
| 直接型 | ASH — AI IDE 界的"Homebrew" |
| 痛点型 | 还在为每个IDE重复配置AI技能?一键搞定! |
| 吸引型 | 装一次技能,8个AI IDE同步,这个工具太香了 |
| 简洁型 | ASH:AI 技能跨平台管理利器 |
其他在线编辑器
CLI 工具方案(备选)
md2wechat
npm install -g md2wechat
npx md2wechat convert your-article.md
npx md2wechat convert your-article.md > output.html
⚠️ 注意:md2wechat 输出可能包含调试信息,需要手动清理 HTML 前的调试内容。
API 自动发布方案(高级)
如果你有已认证的公众号(可获取 AppID 和 AppSecret),可以使用 baoyu-post-to-wechat 技能实现自动化发布。
安装
ash install jimliu/baoyu-skills
配置
在 ~/.baoyu-skills/baoyu-post-to-wechat/EXTEND.md 中配置:
wechat_app_id: your_app_id
wechat_app_secret: your_app_secret
default_publish_method: api
default_author: your_name
使用
配置完成后,AI 助手可以直接调用该 skill 将 Markdown 转换并发布到公众号草稿箱。
⚠️ 限制:未认证的订阅号无法获取 AppSecret,只能使用浏览器方式或手动粘贴。
常见问题
Q: 粘贴后显示 HTML 代码而不是格式化内容?
A: 公众号编辑器需要富文本格式,不能直接粘贴 HTML 源码。请使用 Doocs/md 编辑器的「复制」功能,它会复制富文本格式。
Q: 公众号有字数限制吗?
A: 正规的「文章」没有字数限制。如果遇到限制,可能是粘贴到了「摘要」或「短图文」区域。
Q: 未认证订阅号能用 API 发布吗?
A: 未认证的订阅号无法使用 API 接口(没有 AppSecret),只能手动粘贴发布。
Q: 图片无法显示?
A: 公众号不支持外链图片,需要先将图片上传到公众号素材库,或使用支持公众号的图床服务。
发布流程 Checklist
相关链接