微信公众号 Markdown 排版工具 · 6 套主题一键生成可粘贴 HTML

解决什么

公众号运营者长期面临排版痛点:手动在编辑器里调格式耗时费力,用第三方工具(135编辑器/秀米)又要来回切换平台,粘贴后样式经常丢失。技术内容创作者习惯用 Markdown 写作,但公众号编辑器不直接支持,需要人工转换并重新排版。该项目提供一套自动化流程:写完 Markdown 后,通过 AI Agent(Claude Code/Codex/Cursor)调用预设主题和组件库,生成样式全内联、符合微信平台规范的 HTML,一键复制粘贴即可发布,全程无需手动调格式。

为何火

1455 stars 的热度源于三个核心优势:平台适配彻底(所有样式内联、文字用 <span leaf=""> 包裹,规避公众号会过滤的 <style>/class/grid 等写法)、主题质量高(6 套主题由两位公众号实践者联合打磨,覆盖教程/测评/深度分析等常见题材)、AI Agent 友好(输入输出全是纯文本,任何 Agent 都能调用,不依赖特定模型)。项目在 2026-07-01 创建后一周内即发布正式版,说明作者对需求把握精准且执行力强。

核心功能

• 6 套精选主题:摸鱼绿(默认,适合教程测评)、红白(深度分析)、石墨极简(设计科技)、留白禅意(随笔)、摸鱼票据(工具对比)、橄榄手记(内刊复盘),每套包含完整组件库(设计变量+数十个组件+视觉层级表)
• 主题生成器:通过一句话描述或参考图,让 AI 生成全新主题并保存本地复用
• 智能排版:自动章节编号(末章用 ∞ 或 ///)、每段标记 1-3 个关键词下划线、从正文提炼引言卡与目录、作者签名去重合并
• 内容兼容:支持代码块(深/浅色可选)、图片、GIF(带动图角标)、行内代码、引用、列表、产品徽章
• 双关卡校验:component_lint.py 检查组件库源头,validate_gzh_html.py 检查最终产物,确保 0 ERROR 才交付
• 一键复制:生成带复制按钮的预览页,点击后富文本进剪贴板,直接粘进公众号编辑器

安装

方式一(推荐):

npx skills add https://github.com/isjiamu/gzh-design-skill

方式二:对任意 AI Agent 说"请帮我安装 https://github.com/isjiamu/gzh-design-skill 这个 skill",它会自动 clone 到对应目录

方式三:手动克隆

git clone https://github.com/isjiamu/gzh-design-skill.git ~/.claude/skills/gzh-design

装好后直接对 Agent 说:"用摸鱼绿把这篇文章排成公众号 HTML:article.md",它会自动选主题、读组件库、解析 Markdown、装配 HTML、跑校验、输出预览页。

适合谁

• 公众号运营者:需要高频发文且对排版有要求,用本工具可节省 80% 排版时间
• 技术博主/教程作者:习惯用 Markdown 写作,需要把技术文档转成公众号格式(支持代码块高亮、自动编号)
• 内容团队:多人协作时用 Markdown 统一格式,最后批量转换,保证视觉风格一致
• AI Agent 用户:已在用 Claude Code/Cursor/Codex,可无缝集成该 Skill 扩展能力

不适合:纯图片海报制作、PPT 生成、普通网页开发、非公众号平台排版。项目明确声明"只排版不写作",需先有 Markdown 内容才能使用。

社区评价

暂无足量社区公开讨论,以下为基于项目本身的中立评估:

项目在一周内获得 1455 stars 和 161 forks,说明需求真实且解决方案有效。README 文档详尽(含完整使用流程、主题速查表、常见场景对照),作者提供企业微信交流群二维码,显示出较强的社区运营意愿。技术上采用"约束优于自由"的设计哲学,通过预设主题和脚本校验保证输出质量,而非依赖模型自由发挥,这在实际应用中更可靠。项目由两位公众号实践者联合共建,主题设计和质量标准来自真实运营经验,实用性较强。

选型对比

vs 135编辑器/秀米(商业工具):

• 135/秀米优势:可视化编辑、模板更多、有客服支持
• 本项目优势:完全免费、Markdown 原生支持、AI Agent 自动化、样式不依赖第三方平台、可自定义主题生成器

vs Markdown Nice(同类开源):

• Markdown Nice 是在线编辑器,需手动操作;本项目是 AI Agent Skill,可编程调用
• Markdown Nice 主题更丰富但不可编程生成;本项目内置主题生成器
• 本项目双关卡校验更严格,专门针对公众号平台限制做兜底

取舍建议:偶尔发文且不懂技术选 135/秀米;高频发文且用 Markdown 写作选本项目;需要可视化调整细节选 Markdown Nice。

已知坑

1. 单人维护风险:贡献者数为 1,若作者停更可能影响后续支持(但项目已发布正式版且功能完整)
2. 依赖 AI Agent:必须配合 Claude Code/Cursor 等工具使用,不能独立运行,普通用户有学习成本
3. 主题定制门槛:虽有主题生成器,但理解组件库结构需要一定技术背景,非技术用户难以深度定制
4. 平台规则变化:公众号若调整 HTML 过滤规则,需及时更新校验脚本(README 提到"确定性检查"但仍需人工维护规则库)
5. 图片处理局限:README 未说明图片上传逻辑,可能需手动上传到公众号素材库后再引用 URL
6. AGPL-3.0 传染性:若基于本项目开发商业服务,衍生代码也必须开源,需注意许可证约束

中文用户注意:项目托管在 GitHub 但无需梯子,直接 clone 即可;作者提供企业微信群,国内用户交流方便;全角标点自动规范化,符合中文排版习惯。