md2wechat-skill

Markdown一键发公众号，排版配图全自动

Markdown 一键排版发布微信公众号的 CLI 工具，支持 40+ 排版样式与专业主题、AI 配图、批量发布和多账号管理。写作者只需专注内容，排版发布全自动搞定，是公众号运营者与技术博主的高效利器。

开源 unknown 写作内容

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3669

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类写作内容

开发团队geekjourneyx

所属国家

官网地址https://md2wechat.cn

GitHubhttps://github.com/geekjourneyx/md2wechat-skill

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Go

技术栈/模型agent-cli,ai-agent,ai-writing,claude-code,claude-skills,cli,go,markdown,markdown-converter,markdown-formatter,markdown-to-html,markdown-to-wechat,mcp-server,md2wechat,wechat,wechat-article,wechat-mp,wechat-official-account,wechat-public-account,weixin

GitHub 星标★ 3669

30天Star增速

HF 下载量

上线时间2026-01-11 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

已安装 Node.js 与 npm（项目通过 npm 全局安装）
可访问 npm 源以安装 @geekjourneyx/md2wechat
md2wechat API Key（API 模式的预览与转换需要）
创建微信草稿还需微信凭证与 IP 白名单（见 docs/WECHAT-CREDENTIALS.md）

安装与启动步骤

1全局安装 CLI

用 npm 全局安装 md2wechat 命令行工具，安装完成后即可在终端直接调用 md2wechat 命令。
```
npm install -g @geekjourneyx/md2wechat
```
2确认版本

执行版本命令确认安装成功，加 --json 便于脚本或 Agent 解析输出结果。
```
md2wechat version --json
```
3初始化配置

生成配置文件骨架，后续填入 API Key 等凭证；具体配置项见 docs/CONFIG-WALKTHROUGH.md。
```
md2wechat config init --json
```
4获取并填写 API Key

API 模式的预览和转换需要 md2wechat API Key，可在官网价格页获取专业 API 后写入配置。
5校验配置

检查凭证配置是否正确，校验通过后再执行后续转换，避免中途失败。
```
md2wechat config validate --json
```
6检查文章

先检查 Markdown 的标题、摘要、图片与草稿就绪状态，此命令不会上传图片或创建草稿。
```
md2wechat inspect article.md --json
```
7生成预览与 HTML

把排版结果写入本地文件，preview 用于预览、convert 生成最终 HTML，均为只读操作。
```
md2wechat preview article.md --output preview.html
md2wechat convert article.md --output article.html
```
8推送微信草稿

需要创建草稿时显式加 --draft 与 --cover；若用 --wechat-account，两条命令必须传同一账号名。
```
md2wechat inspect article.md --draft --cover cover.jpg --json
md2wechat convert article.md --draft --cover cover.jpg
```

关键配置

配置项	必填	说明	示例
`md2wechat API Key`	是	API 模式预览与转换的凭证，通过 config init 生成后填写	`sk-xxxxxxxx`
`wechat-account`	否	多账号场景下指定命名公众号账号，inspect 与 convert 必须一致	`my-account`

如何确认成功

运行 md2wechat version --json 能输出版本信息，且 md2wechat config validate --json 校验通过。

常见问题

Q：预览或转换时报错缺少凭证？

A：API 模式的预览和转换需要 md2wechat API Key。先执行 md2wechat config init --json 生成配置，再填入从官网获取的 API Key，并用 config validate 校验。

Q：为什么执行命令后公众号里没有草稿？

A：inspect、preview、convert 默认不会上传图片或创建草稿。需要草稿时必须在 inspect 和 convert 上显式加 --draft 与 --cover 参数。

Q：多账号发布要注意什么？

A：使用 --wechat-account 指定账号名时，inspect 和 convert 两条命令必须传入同一个账号名，否则目标不一致。还可本地只读发现账号，不会输出 Secret。

Q：商业使用是否免费？

A：项目采用 Source Available License，个人使用、学习、评估、非营利使用免费；商业使用、SaaS、客户交付、白标、再分发和训练数据用途需要商业授权。

注意事项

只读命令（inspect、preview、convert）不会上传图片或创建草稿，副作用操作需显式加 --draft。
使用 --wechat-account 时，inspect 与 convert 必须传同一个账号名。
安装方式、微信凭证与 IP 白名单、完整配置说明分别见 docs/INSTALL.md、docs/WECHAT-CREDENTIALS.md、docs/CONFIG-WALKTHROUGH.md。
商业使用、SaaS、白标、再分发和训练数据用途需商业授权，可联系 skrphper@gmail.com。

核心亮点

一键将 Markdown 转换为微信公众号排版，支持 40+ 样式和专业主题，显著提升排版效率
集成 AI 配图功能，自动为文章生成配图，减少手动找图成本
支持批量发布和多账号管理，适合内容团队或运营者高频发布场景

不足之处

文档/社区待观察

适用场景

技术博客作者快速排版发布到公众号
内容运营团队批量管理多个公众号并发布文章
需要统一风格排版且希望自动化配图的写作场景

替代项目

md2wechat、wechat-format、doocs/md

项目介绍

md2wechat-skill 是写作内容领域的开源项目，由 geekjourneyx 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,669）位列前 30%，在写作内容分类的 183 个项目里位列前 10%。

近 42 天，它的 GitHub 星标从 3,498 增加到 3,669，净增 171。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：技术博客作者快速排版发布到公众号。同类可对比的替代方案包括 md2wechat、wechat-format、doocs/md。

上一篇：chatgpt-prompts-for-academic-writing

下一篇：avoid-ai-writing