对于长期运营微信公众号的作者来说，写文章本身往往只是整个流程中的一部分。真正耗费时间的环节通常集中在后续处理，例如调整排版、制作封面、生成配图、检查文章格式、上传图片以及发布草稿。
尤其对于习惯使用 Markdown 写作的技术作者、自媒体创作者来说，Markdown 拥有结构清晰、方便版本管理和适合程序化处理等优势，但微信公众号编辑器对于 Markdown 并没有原生支持，因此很多作者需要在两个环境之间反复复制、调整格式。
软件格律诗 今天推荐的 md2wechat 是一款“面向 AI Agent 的微信公众号创作与发布 CLI”，能够将 Markdown 内容转换为公众号排版内容，并支持制作封面、文章配图、预览校验以及推送到微信草稿箱。
与此同时，md2wechat 还针对 AI Agent 工作流进行了设计，支持 Claude Code、Codex、WorkBuddy、Kimi Work、Hermes Agent、OpenClaw 等 Agent 通过 JSON discovery 方式稳定调用。
对于已经习惯使用 AI 辅助写作的创作者来说，md2wechat 提供了一套更加自动化的公众号生产流程，让文章创作、排版和发布之间的衔接更加顺畅。
md2wechat 核心功能特点
Markdown 转微信公众号 HTML，让写作与发布保持统一
md2wechat 最核心的能力，就是将 Markdown 文档转换为适合微信公众号发布的 HTML 内容。
项目将公众号发布流程拆分成多个可验证的 CLI 命令，其中 Markdown 转微信 HTML 对应 convert 命令，并支持预览、上传图片以及创建草稿等能力。
对于习惯使用 Markdown 管理文章的人来说，可以继续保持原有写作习惯，不需要重新适应微信公众号编辑器复杂的格式调整流程。
整个过程更加接近现代内容生产工作流：使用 Markdown 完成文章创作；通过 md2wechat 完成格式转换；检查文章状态；生成最终内容；推送微信公众号草稿。
这种方式尤其适合技术博客作者、独立开发者以及需要持续输出内容的团队。
专业级微信公众号排版系统，提供丰富主题与高级布局
公众号文章的视觉效果会直接影响阅读体验，因此排版能力是 md2wechat 的重要组成部分。
根据 README 信息，md2wechat 专业 API 模式支持 48 个微信渲染精调主题，并提供 68 个主推高级排版场景，对应 53 个主推 :::module 语法名。
这些能力让作者可以通过 Markdown 语法描述文章结构，再由 md2wechat 渲染为微信公众号适用的视觉效果。
例如：
:::hero
eyebrow: 深度观察
title: AI 时代的公众号写作
subtitle: 为什么读者愿意继续读下去
:::这种结构化方式能够让文章内容和排版逻辑保持分离，作者关注内容本身，工具负责呈现效果。
48 个微信渲染主题，让文章拥有统一视觉风格
在专业 API 模式下，md2wechat 提供 48 个微信渲染精调主题。相比传统复制粘贴文章后再手动调整样式，主题系统可以帮助创作者快速建立稳定的视觉风格。
对于运营多个栏目或者长期更新公众号的作者来说，统一的文章视觉体系能够增强账号辨识度，同时降低每篇文章的排版成本。
高级排版模块：通过 :::module 实现结构化内容设计
md2wechat 支持使用 :::module 语法进行高级排版，API 模式支持 :::module 语法，通过 Markdown 编写结构化公众号排版内容。
同时，项目提供命令用于查看和验证排版模块：
md2wechat layout list --json
md2wechat layout show hero --json
md2wechat layout validate --file article.md --json需要注意的是，本地 layout validate 主要用于验证语法，实际渲染效果需要通过 API 的 preview 或 convert 进行确认。
这种设计更适合自动化内容生产，让 AI Agent 或脚本能够更加稳定地生成符合规范的公众号文章。
AI 辅助创作：从文章生成到内容优化
除了排版和发布，md2wechat 还提供内容生产相关能力。
README 中列出了：
write：从想法生成文章；humanize：重写 AI 文章，支持 authentic 强度；title suggest：生成公众号标题建议；generate_cover：生成封面图或图片计划；generate_infographic：生成信息图或图片计划。
这些功能覆盖了公众号创作过程中的多个环节。
对于使用 AI 辅助写作的用户来说，可以先利用 AI 完成内容构思，再通过 md2wechat 完成标题优化、文章润色、视觉设计以及发布准备。
AI 封面图与信息图生成，让文章视觉更加完整
公众号文章通常需要配套封面和插图，而 md2wechat 将图片生成能力纳入整体工作流。
项目支持两条图片路径：一种是调用图片 provider；另一种是使用宿主 Agent 的 Image Gen 能力。
支持的图片服务包括：
- Volcengine；
- ModelScope；
- OpenRouter；
- OpenAI；
- Gemini。
同时，用户可以通过：
md2wechat generate_cover --article article.md生成文章封面。
也可以通过：
md2wechat generate_infographic --article article.md生成信息图。
对于需要持续发布内容的公众号作者来说，将图片生成流程整合进 CLI 工作流，可以减少重复操作。
面向 AI Agent 的工作流设计
md2wechat 最大的特点之一，是它并非只面向普通命令行用户，而是针对 AI Agent 场景进行了设计。
项目提供 discovery 相关命令：
md2wechat capabilities --json
md2wechat doctor --json
md2wechat inspect article.md --json
md2wechat themes list --json
md2wechat layout list --json
md2wechat title suggest article.md --json通过这些 JSON 输出能力，Agent 可以获取当前 CLI 支持的能力、主题、排版模块以及文章状态。
README 中说明，Agent 可以据此判断：
- 当前 CLI 支持哪些命令；
- API、草稿、上传是否具备执行条件；
- 某篇文章能否发布草稿；
- 当前主题和排版模块是否可用。
这让 md2wechat 更像一个公众号内容生产基础设施，而不仅是一款简单格式转换工具。
多公众号账号管理，适合团队和矩阵运营
对于运营多个微信公众号账号的团队来说，账号管理也是一个重要需求。md2wechat 支持命名公众号账号，并且采用本地只读发现方式，不输出 Secret。
专业 API 模式还支持多公众号账号配置。这为团队运营、客户公众号管理以及矩阵账号场景提供了更加规范的管理方式。
md2wechat 使用教程
安装 md2wechat CLI
首先通过 npm 安装：
npm install -g @geekjourneyx/md2wechat安装完成后，可以检查版本：
md2wechat version --json然后初始化配置：
md2wechat config init --json
md2wechat config validate --json创建文章并检查状态
准备一篇 Markdown 文件，例如：
article.md执行检查：
md2wechat inspect article.md --json该命令会返回文章 metadata、检查结果、readiness targets 以及 blockers。
通过检查后，可以生成预览：
md2wechat preview article.md --output preview.html或者转换为 HTML：
md2wechat convert article.md --output article.html创建微信公众号草稿
如果需要创建微信草稿，需要明确执行带副作用的命令：
md2wechat inspect article.md --draft --cover cover.jpg --json
md2wechat convert article.md --draft --cover cover.jpg如果使用指定公众号账号，需要保证 inspect 和 convert 使用相同的账号名称。
我的使用体验
从实际使用角度来看，md2wechat 给我的最大感受是，它把微信公众号运营中大量重复性的机械工作进行了重新整理。
对于习惯使用 Markdown 写作的人来说，最大的变化是写作环境终于可以和发布平台连接起来。过去需要在 Markdown 编辑器、图片工具、微信公众号后台之间不断切换，而 md2wechat 将这些环节通过 CLI 串联起来。
其中我比较喜欢的是它对于 AI Agent 的支持。随着 AI 编程助手和自动化工作流的发展，未来很多内容生产流程都会由 Agent 协助完成。md2wechat 提供 JSON discovery 和明确命令边界，使 Agent 更容易理解当前环境和执行条件。
另外，结构化排版能力也非常适合科技类、自媒体类文章。通过 Markdown 编写内容，再利用主题和模块完成视觉呈现，比手动调整微信公众号格式更加稳定。
md2wechat 更偏向开发者和高级用户工具。如果只是偶尔发布一篇公众号文章，传统编辑器可能已经足够；但对于持续输出内容、运营多个账号或者希望构建自动化内容流水线的人来说，它提供了更大的发挥空间。
总结：让微信公众号创作从手工操作走向自动化流程
md2wechat 是一款面向 AI Agent 和自动化内容生产场景设计的微信公众号 CLI 工具。
它连接了 Markdown 写作、公众号排版、AI 图片生成、文章检查、草稿发布以及 Agent 工作流，让内容创作者能够建立更加稳定、高效的生产流程。
从 Markdown 转换到微信 HTML，到 48 个专业主题、68个高级排版场景，再到多账号管理和 API 自动化能力，md2wechat 展现出的方向已经超越简单排版工具，更像是一套面向未来内容生产的基础工具链。
对于技术作者、AI 内容创作者、自媒体团队以及希望提高公众号运营效率的用户来说，md2wechat 值得关注和体验。
官方网站
https://github.com/geekjourneyx/md2wechat-skill
