微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown 先自动归一化），也支持"一键自动排版"（自动推断结构+选主题），还支持根据用户描述/参考图生成自定义主题组件库并保存本地复用。触发场景：(1) 用户提到"公众号排版""公众号文章""微信排版""gzh"，(2) 用户想把文章（md/docx/pdf/纯文本）转成公众号 HTML，(3) 用户说"自动排版""一键排版"公众号内容，(4) 用户想为公众号排版"生成新主题/自定义风格/按这张图做一套组件库"。不用于生成普通网页/落地页/PPT（用前端或 PPT 类 skill）。
How to install gzh-design-skill?
isjiamu/gzh-design-skill
$npx -y skills add isjiamu/gzh-design-skill --skill gzh-design-skillInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Run `npx skills use "https://github.com/isjiamu/gzh-design-skill" --skill "isjiamu/gzh-design-skill"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/isjiamu/gzh-design-skill" that are relevant to the current task. Run `npx skills add "https://github.com/isjiamu/gzh-design-skill"` and select the relevant skills, then follow their instructions.
SKILL.md
| 1 | > 🤝 **本项目由 甲木 × [「摸鱼小李」](https://mp.weixin.qq.com/s/EMahAzgfAbRQrYukWE7_IQ) 联名共建** —— 排版组件、主题设计与质量标准凝聚了两人的公众号实践与共同打磨，特别感谢小李。 |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | # gzh-design-skill · 公众号排版技能 |
| 6 | |
| 7 | **把 Markdown 一键排成可直接粘贴进微信公众号编辑器的精致 HTML** |
| 8 | |
| 9 | 6 套精选主题 + 主题生成器 · 代码块/图片/GIF · 自动章节编号与关键词标记 · 双关卡质量校验 |
| 10 | |
| 11 | [](LICENSE) |
| 12 | [](https://claude.ai/code) |
| 13 | [](references/theme-index.md) |
| 14 | [](CONTRIBUTING.md) |
| 15 | [](#-快速开始) |
| 16 | |
| 17 | [English](README.en.md) ｜ 中文 |
| 18 | |
| 19 | </div> |
| 20 | |
| 21 | --- |
| 22 | |
| 23 | 一个给 AI Agent（Claude Code / Codex / Cursor 等）用的公众号排版 Skill。你写完 Markdown，它按你选的主题，生成**样式全内联、粘贴到公众号编辑器不掉格式**的 HTML——自动编章节号、标关键词下划线、配引言卡与目录、处理代码块和图片、合并作者签名，并用脚本确定性地兜住公众号平台的各种限制。 |
| 24 | |
| 25 | ## ✨ 核心特性 |
| 26 | |
| 27 | - **6 套精选主题**：摸鱼绿（默认）· 红白 · 石墨极简 · 留白禅意 · 摸鱼票据 · 橄榄手记 —— 每套都是自成体系的厚组件库（设计变量 + 数十个精细组件 + 视觉层级表 + 文章类型配方表）。 |
| 28 | - **主题生成器**：不满足现成主题？用一句话描述或一张参考图，生成一套全新组件库并保存本地复用（见 `references/theme-generator.md`）。 |
| 29 | - **内容全兼容**：代码块（深/浅色，等宽不折行）、图片、GIF（带动图角标）、行内代码、引用、列表、产品徽章。 |
| 30 | - **智能排版**：章节自动编号（末章 ∞ / ///）、每段主动标 1–3 个关键词下划线、从正文提炼引言卡与目录、作者签名去重合并。 |
| 31 | - **中文全角标点**：正文自动规范全角，代码块内原样保留。 |
| 32 | - **不掉格式**：所有样式内联、文字 `<span leaf="">` 包裹，规避 `<style>/<div>/class/grid/position` 等公众号会过滤的写法。 |
| 33 | - **双关卡质量校验**：`component_lint.py`（组件库源头）+ `validate_gzh_html.py`（最终产物），构成可复现的「改→验→修」闭环。 |
| 34 | - **一键复制**：生成带「复制」按钮的预览页，点一下把富文本复制到剪贴板，直接粘进公众号，免手动全选。 |
| 35 | |
| 36 | ## 👀 效果预览 |
| 37 | |
| 38 | 6 套主题各排同一篇长文（真实长图，含配图、引言卡、编号章节、金句、名词旁注等完整组件）： |
| 39 | |
| 40 | <table> |
| 41 | <tr> |
| 42 | <td colspan="3" align="center"><img src="https://origin.picgo.net/2026/07/07/-40619312d679bc34.jpg" width="100%"><br><sub><b>摸鱼绿（默认）</b></sub></td> |
| 43 | </tr> |
| 44 | <tr> |
| 45 | <td colspan="3" align="center"><img src="https://origin.picgo.net/2026/07/07/-084eb2b9d6f8d5e2.jpg" width="100%"><br><sub><b>红白色系</b></sub></td> |
| 46 | </tr> |
| 47 | <tr> |
| 48 | <td colspan="3" align="center"><img src="https://origin.picgo.net/2026/07/07/-747b33f502544254.jpg" width="100%"><br><sub><b>橄榄手记</b></sub></td> |
| 49 | </tr> |
| 50 | <tr> |
| 51 | <td width="33%" align="center"><img src="https://github.com/isjiamu/gzh-design-skill/releases/download/assets-v1/lf-graphite-minimal.png?v=1" width="250"><br><sub><b>石墨极简风</b></sub></td> |
| 52 | <td width="33%" align="center"><img src="https://github.com/isjiamu/gzh-design-skill/releases/download/assets-v1/lf-zen-whitespace.png?v=1" width="250"><br><sub><b>留白禅意风</b></sub></td> |
| 53 | <td width="33%" align="center"><img src="https://github.com/isjiamu/gzh-design-skill/releases/download/assets-v1/lf-moyu-ticket.png?v=1" width="250"><br><sub><b>摸鱼票据风</b></sub></td> |
| 54 | </tr> |
| 55 | </table> |
| 56 | |
| 57 | > 📚 **6 套完整长图 → [docs/all-themes.md](docs/all-themes.md)** ｜ 克隆后浏览器打开 `docs/gallery/index.html` 可看可交互的完整 HTML。 |
| 58 | |
| 59 | ## ✅ 适合 / ❌ 不适合 |
| 60 | |
| 61 | **✅ 适合**：观点/深度分析 · 教程/操作指南 · 测评/工具盘点 · 知识整理/方法论 · 访谈/人物特稿 · 数据复盘/报告 · 生活/情感随笔 · 案例实战 —— 把 Markdown / Word / PDF / 纯文本长文，一键排成可直接粘进公众号编辑器的 HTML；也能按描述或参考图生成自定义主题。 |
| 62 | |
| 63 | **❌ 不适合**：普通网页/落地页（用前端 skill）· PPT（用 PPT skill）· 纯图片海报/社交卡片（用社交卡片类 skill）· 非公众号平台的排版 · **代写文章**（本 skill 只排版、不写作——先有 Markdown 再用它）。 |
| 64 | |
| 65 | ## 🗂 常见使用场景 |
| 66 | |
| 67 | | 你的内容 | 推荐怎么排 | |
| 68 | |---|---| |
| 69 | | 观点 / 深度长文 | 红白 或 石墨极简；关键词下划线 + 金句引用 + 居中金句 | |
| 70 | | 产品测评 / 工具盘点 | 摸鱼绿 或 摸鱼票据；step/tool-label + 卡片，按配方表走 | |
| 71 | | 教程 / 操作指南 | 摸鱼绿；step-label + 代码块 + 编号列表 | |
| 72 | | 数据复盘 / 年度报告 | 摸鱼绿 或 橄榄手记；数据卡 + 表格 | |
| 73 | | 禅意 / 极简随笔 | 留白禅意；大留白 + 居中衬线引用 | |
| 74 | | 内刊 / 深度评测 / 案例复盘 | 橄榄手记；编者按 + 分节 + 暗色摘要框 | |
| 75 | | Word / PDF 稿转公众号 | 先自动格式归一化 → 再按题材选主题 | |
| 76 | | 想要现成之外的风格 | 主题生成器：一句话或参考图现造一套 | |
| 77 | |
| 78 | ## 🎨 6 套精选主题 |
| 79 | |
| 80 | 覆盖绝大多数公众号题材，每套都打磨到「拿来即用」： |
| 81 | |
| 82 | | 主题 | 适合 | |
| 83 | |---|---| |
| 84 | | **摸鱼绿**（默认） | 教程、测评、清单、工具盘点（卡片丰富、信息密度高） | |
| 85 | | **红白色系** | 深度分析、观点、力量感话题（经典编辑风） | |
| 86 | | **石墨极简风** | 设计、科技评论、专业观点、高端品牌 | |
| 87 | | **留白禅意风** | 禅意、极简生活、深度随笔（呼吸感最强） | |
| 88 | | **摸鱼票据风** | 工具对比、创意评测（票据视觉隐喻） | |
| 89 | | **橄榄手记** | 内刊手记、深度评测、案例复盘（编辑部内刊质感） | |
| 90 | |
| 91 | > 主色、下划线色值等**完整速查表见文末 [附录](#-完整主题速查表)**；不够用就让 AI [生成新主题](#-faq)。 |
| 92 | |
| 93 | ## 🚀 快速开始 |
| 94 | |
| 95 | ### 方式一：一行安装（推荐） |
| 96 | |
| 97 | ```bash |
| 98 | npx skills add https://github.com/isjiamu/gzh-design-skill |
| 99 | ``` |
| 100 | |
| 101 | ### 方式二：让 AI 自己装 |
| 102 | |
| 103 | 对**任意 Agent**（Claude Code |
Related
6 picksType
- edit-articleEdit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.Jul 2026
- writing-shapeWriting, exploit — shape raw material into an article, paragraph by paragraph.Jul 2026
- writing-fragmentsWriting, explore — mine raw fragments, no structure yet.Jul 2026
- writing-beatsWriting, exploit — assemble raw material into a journey of beats, grounding each term before a beat leans on it.Jul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages,…Jul 2026
- slideshowAuthor a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and…Jul 2026
