科技前沿 Skill推荐推荐教程公众号

gzh-design-skill:公众号排版,永不掉格式

📅 2026-07-22

白物集的内容管线每天产出早报、热点深度、教程系列等多篇长文。文章写好之后,除了发布到网站(baiwuji.top),还要同步到微信公众号。公众号编辑器的排版是个众所周知的痛点——从 Markdown 复制过去,样式全部丢失,手动调格式一篇文章要花 20 分钟。

gzh-design-skill 解决的就是这个问题。它把 Markdown 一键排版成样式全内联、粘贴到公众号编辑器不掉格式的精致 HTML。目前 2,407 stars,274 forks,项目地址 github.com/isjiamu/gzh-design-skill,7 月 1 日上线至今三周,增长极快。

三个最惊艳的设计

1. 6 套精选主题 + 主题生成器,覆盖所有公众号题材

摸鱼绿(默认)、红白色系、石墨极简、留白禅意、摸鱼票据、橄榄手记——每套都是自成体系的组件库,包含设计变量表、数十个精细组件、视觉层级表和文章类型配方表。写教程选摸鱼绿,深度分析选红白,科技评论选石墨极简。

不够用?让 AI 现场造一套新主题。给一句描述(如「黑白杂志、克莱因蓝点睛、衬线字体」)或一张参考图,主题生成器产出 45-75 个区块的完整组件库,确认后即可像内置主题一样使用。仓库里已经附带了一套「墨蓝刊读风」样例。

2. 平台限制全部内置为确定性校验,不靠模型自觉

公众号编辑器会过滤 <style><div>class/idposition: fixedfloatdisplay: grid、CSS 变量、外部字体。gzh-design-skill 生成的 HTML 严格遵守这些限制:样式全部内联,每个文字节点用 <span leaf=""> 包裹,并且用 validate_gzh_html.py 脚本确定性检查——0 ERROR 才交付,不依赖模型「记得住」。

更绝的是双关卡质量闭环:component_lint.py 检查组件库源头反模式,validate_gzh_html.py 检查最终产物合规。源头干净,产物必然干净。

3. Agent 原生格式,天然适配 Claude Code / Codex / Cursor

整个技能是一个标准的 Agent Skill:SKILL.md 定义工作流,references/ 存放主题库和组件库,scripts/ 放校验脚本。输入输出全是纯文本 Markdown/HTML,任何 Agent 都能读、写、改、验。

安装只需一行:npx skills add https://github.com/isjiamu/gzh-design-skill。装好后对 Agent 说「用摸鱼绿把这篇文章排成公众号 HTML:article.md」,3 秒生成带「复制」按钮的预览页,点一下粘进公众号编辑器即可。

白物集的实际使用场景

白物集的内容管线每天多通道分发:网站(Astro SSR)、微信公众号、小程序。网站用 content_html(经过 clean-md + markdown 库转的 HTML),但公众号不能直接用这套 HTML——Astro 的页面结构和公众号编辑器不兼容。

之前有两种做法:一是手动在公众号编辑器里重新排版,一篇长文改 20 分钟,而且排版效果不可复现;二是用基本的内联样式,但代码块、引用卡、关键词下划线这些精细排版做不到。

有了 gzh-design-skill,流程变成了:

Markdown 写稿 → 对 Agent 说「排成公众号 HTML」
→ 生成预览页 → 复制 → 粘贴到公众号编辑器 → 发布

一篇教程文章从 Markdown 到公众号发布,从 20 分钟降到 1 分钟。而且因为所有排版逻辑都沉淀在组件库里,换模型(Claude / GPT / DeepSeek)也能跑出一致效果,不绑定某家 AI。

适合什么场景

适合: 观点/深度分析、教程/操作指南、测评/工具盘点、知识整理/方法论、案例实战——把所有 Markdown / Word / PDF 长文,一键排成可直接粘贴进公众号编辑器的 HTML。如果团队有多人运营公众号,这套工具能确保每个人发出的文章排版风格一致。

不适合: 普通网页/落地页(用前端框架更合适)、纯图片海报/社交卡片、非公众号平台的排版(如知乎文章需要不同的样式体系)。它只负责排版,不代写文章——你得先有 Markdown 内容再用它。

快速上手

第一步:安装

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

或者让 AI Agent 自己装——对 Claude Code / Codex 说一句「请帮我查找并安装 gzh-design-skill」。

第二步:写 Markdown

写一篇公众号文章,保存为 .md 文件。标题用 #,章节用 ## / ###,代码块用 fences,图片用 ![]()

第三步:让 Agent 排版

对 Agent 说:

用摸鱼绿把这篇文章排成公众号 HTML:article.md

Agent 会读取组件库、解析 Markdown、装配 HTML、跑校验脚本。

第四步:复制到公众号

生成的预览页带「复制」按钮,在浏览器打开,点击复制,直接粘贴到微信公众号编辑器。所有内联样式都在,格式丝滑不塌。

第五步:微调主题(可选)

不满意现成主题?让 AI 生成新的:「按黑白杂志、克莱因蓝点睛的气质,给公众号排版生成一套新主题」。生成后即可投入使用。

← 白物集完整架构复盘:从零到上线一个内容网站 → Apple 频道 从零到全栈:一条完整的网站开发学习路线图 →
🍎 Apple 深度分析
本文基于 Apple 公开资料及行业分析撰写。观点仅供参考与学习交流。