md2wechat-skill：让 AI Agent 一条命令把 Markdown 发进公众号

往公众号发文章就是和平台编辑器搏斗：图片挂掉、代码块塌掉、样式粘贴出来全靠缘分。geekjourneyx/md2wechat-skill——3.6k 星——把这条流程拆成一组你和 AI agent 都能跑的可验证 CLI 命令：发布前先检查、用稳定主题转换、只有你明确说了才推送草稿。

为什么这个 Skill 重要

md2wechat 和一般"Markdown 转微信 HTML"工具的差别在命令边界设计。inspect --json 返回结构化的 metadata、checks 和 readiness targets——agent 在动任何东西之前就能判断这篇文章到底能不能发。convert 负责转换，但上传和草稿这类副作用只在用户明确请求时通过 --draft 执行。还有一层 discovery 命令（capabilities、doctor、themes list、layout list），让 agent 直接问 CLI 支持什么，而不是靠猜。README 列出的可驱动它的 agent 包括 Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent 和 OpenClaw，全部通过 JSON discovery 调用。

安装

CLI 通过 npm 全局安装：

npm install -g @geekjourneyx/md2wechat
md2wechat version --json
md2wechat config init --json
md2wechat config validate --json

API 模式的预览和转换需要 md2wechat API Key，在 md2wechat.cn 获取——专业 API 是 ¥199 一次性买断。另有免费的 AI 模式：生成一段 prompt 交给外部 LLM 完成 HTML，而不是直接返回结果。

实战：从文章到草稿箱

article.md 已经写好，要走完检查、预览、推送草稿。

1. 先检查——这一步不上传任何东西：

md2wechat inspect article.md --json

2. 预览和转换只写本地文件：

md2wechat preview article.md --output preview.html
md2wechat convert article.md --output article.html

3. 确认要发布时，执行显式副作用：

md2wechat inspect article.md --draft --cover cover.jpg --json
md2wechat convert article.md --draft --cover cover.jpg

如果管理多个公众号，inspect 和 convert 两条命令必须传同一个 --wechat-account 账号名。

实战：用 Discovery 命令挑主题

转换之前，直接问 CLI 有什么可用——输出全是 JSON：

md2wechat themes list --json
md2wechat layout list --json
md2wechat title suggest article.md --json

专业 API 模式覆盖 48 个微信渲染精调主题和 56 个推荐 ::: 排版语法名（对应 77 个主推排版场景条目）；免费模式有 3 个基础主题。长期风格偏好写进 Brand Profile（~/.config/md2wechat/brand.md），agent 在写作和排版时会读取它。

技巧

• 任何带副作用的命令之前先 inspect——JSON 里有 readiness targets 和 blockers。
• 输出是 stdout 上的单行 JSON；自己看的时候接 | jq，别要求 CLI 改成缩进输出。
• doctor --json 检查本机的 API、草稿、上传前置条件是否满足。
• 微信凭证、IP 白名单等配置，README 的 docs 目录里有专门的指南。

何时不用这个 Skill

这是一条微信专用流水线——小红书、博客或其他平台需要别的工具。许可是 source-available 而非开源，稳定转换是付费 API；如果只是偶尔转一次、手头又有 LLM，免费 AI 模式够用。

查看 排行榜 了解更多 skill。