gzh-design-skill常见问题解答：排版新手必看指南

gzh-design-skill常见问题解答排版新手必看指南【免费下载链接】gzh-design-skill把 Markdown 一键排成可直接粘进公众号编辑器的精致 HTML —— 6 套精选主题 主题生成器 双关卡校验。An AI-agent skill that turns Markdown into paste-ready WeChat article HTML.项目地址: https://gitcode.com/gh_mirrors/gz/gzh-design-skill如果你正在寻找一款一键将Markdown转换为可直接粘贴到微信公众号编辑器的HTML排版工具gzh-design-skill可能是你的完美选择。这个AI助手技能专为公众号排版设计提供6套精选主题和主题生成器让排版变得简单高效。无论你是技术博主、内容创作者还是普通用户这个工具都能帮你快速生成精美的公众号文章排版。 gzh-design-skill到底是什么gzh-design-skill是一个专门为AI助手如Claude Code、Codex、Cursor等设计的公众号排版技能。它的核心功能是将Markdown文档一键转换为可直接粘贴到微信公众号编辑器的HTML代码同时确保粘贴后样式不丢失。主要特点6套精选主题摸鱼绿默认、红白色系、石墨极简风、留白禅意风、摸鱼票据风、橄榄手记主题生成器可自定义生成全新主题组件库智能排版功能自动章节编号、关键词下划线标记、引言卡片生成双关卡质量校验确保生成的HTML完全符合公众号平台限制 如何快速开始使用安装方法方法一一行命令安装推荐npx skills add https://gitcode.com/gh_mirrors/gz/gzh-design-skill方法二让AI助手自动安装直接对AI助手说请帮我查找并自动安装 https://gitcode.com/gh_mirrors/gz/gzh-design-skill 这个skill方法三手动克隆git clone https://gitcode.com/gh_mirrors/gz/gzh-design-skill.git ~/.claude/skills/gzh-design基本使用流程选择主题根据文章类型选择最合适的主题准备Markdown准备好要排版的Markdown文档让AI助手排版对AI助手说用摸鱼绿把这篇文章排成公众号HTML复制粘贴使用生成的预览页一键复制粘贴到公众号编辑器❓ 常见问题解答1. 粘贴到公众号后样式会丢失吗不会这是gzh-design-skill的核心优势之一。所有样式都采用内联方式并且每个文字节点都用span leaf包裹专门规避了公众号编辑器会过滤的写法。项目还提供了scripts/validate_gzh_html.py脚本进行确定性检查确保生成的HTML完全符合公众号平台要求。2. 支持哪些输入格式直接支持Markdown文件或文本间接支持Word文档(.docx)、PDF文件、纯文本格式转换非Markdown格式会先通过references/format-normalize.md进行格式归一化处理3. 只能在Claude Code中使用吗不限制任何能够读取Skill目录的AI助手都可以使用包括Claude CodeCodexCursor以及其他兼容的AI助手工作流程定义在SKILL.md文件中所有模型都能运行出一致的效果。4. 如何选择适合的主题根据你的文章类型选择文章类型推荐主题特点教程/操作指南摸鱼绿信息密度高卡片丰富深度分析/观点红白色系经典编辑风格设计/科技评论石墨极简风极简克制专业感强禅意/随笔留白禅意风呼吸感最强工具对比摸鱼票据风票据视觉隐喻内刊/案例复盘橄榄手记编辑部质感5. 如何自定义主题如果你对现有的6套主题不满意有两种方式自定义方法一让AI生成新主题告诉AI助手按这个风格/这张图生成一套公众号主题AI会按照references/theme-generator.md中的流程生成全新的主题组件库。方法二手动创建主题按照CONTRIBUTING.md中的新增一套主题风格指引创建自己的主题并提交PR。6. 生成的HTML符合公众号平台限制吗完全符合gzh-design-skill严格遵守公众号平台的所有限制禁止使用style、script、div标签禁止使用class和id属性禁止使用position: fixed/absolute/sticky禁止使用float布局禁止使用media媒体查询禁止使用CSS变量和外部字体所有样式都采用内联方式确保粘贴后样式不丢失。7. 如何验证生成的HTML质量项目提供了双关卡质量校验第一关组件库源头检查python3 scripts/component_lint.py .检查组件库中是否存在平台禁用项。第二关最终产物校验python3 scripts/validate_gzh_html.py out.html检查生成的HTML是否完全符合公众号要求。8. 如何处理代码块和图片gzh-design-skill通过references/common-components.md中的通用增量库统一处理代码块支持深色/浅色主题等宽字体不折行图片/GIF自动添加说明GIF带有动图角标行内代码特殊样式标记9. 如何更新到最新版本方法一重新安装npx skills add https://gitcode.com/gh_mirrors/gz/gzh-design-skill方法二手动更新进入安装目录执行git pull10. 遇到问题怎么办检查步骤运行scripts/validate_gzh_html.py检查HTML合规性查看错误信息返回装配步骤修复确保两关校验都通过0 ERROR0 WARNING如果仍有问题可以参考references/eval-cases.md中的触发用例或查看官方文档。 实用技巧技巧一全自动模式如果你想让AI助手完全自动处理可以说直接排、自动排或一键排版。AI会自动推断文章结构根据题材选择最合适的主题自动完成排版和校验交付时附上决策说明技巧二批量生成多套主题想要对比不同主题的效果告诉AI用这几套主题各排一遍这篇AI会批量生成多套HTML供你选择。技巧三智能章节编号gzh-design-skill会自动为章节编号01/02/03...如果是结语或总结章节会自动使用主题库指定的特殊编号如∞。技巧四关键词标记每段文字会自动标记1-3个关键词使用主题对应的下划线颜色既突出重点又不影响阅读体验。 最佳实践1. 选择合适的文章类型在开始排版前先确定文章类型观点/深度分析→ 红白色系或石墨极简风教程/操作指南→ 摸鱼绿产品测评/工具盘点→ 摸鱼绿或摸鱼票据风数据复盘/年度报告→ 摸鱼绿或橄榄手记禅意/极简随笔→ 留白禅意风2. 准备干净的Markdown确保你的Markdown文档使用标准的Markdown语法标题层级清晰#、##、###图片链接正确代码块格式规范3. 利用主题生成器如果现有主题都不符合你的需求不要勉强使用。直接让AI助手生成全新主题提供主题描述按黑白杂志、克莱因蓝点睛、衬线字体的气质生成一套新主题提供参考图片按这张参考图做一套公众号排版组件库4. 定期更新关注项目更新新版本可能包含新的主题风格优化的组件库更好的兼容性修复的问题 主题速查表主题主色适用场景英文标识摸鱼绿#059669教程、测评、清单、工具盘点moyu-green红白色系#DC2626深度分析、观点、力量感话题red-white石墨极简风#52525B设计、科技评论、专业观点graphite-minimal留白禅意风#4A5D52禅意、极简生活、深度随笔zen-whitespace摸鱼票据风#059669工具对比、创意评测moyu-ticket橄榄手记#1e1f23内刊手记、深度评测、案例复盘olive-journal 技术细节项目结构gzh-design-skill/ ├── SKILL.md # 排版工作流主文档 ├── references/ │ ├── theme-index.md # 6套主题索引 │ ├── theme-*.md # 主题组件库 │ ├── theme-generator.md # 主题生成器 │ ├── common-components.md # 通用增量组件 │ └── format-normalize.md # 格式归一化 ├── scripts/ │ ├── validate_gzh_html.py # 产物合规校验 │ └── component_lint.py # 组件库源头检查 └── docs/ # 文档和预览核心设计原则约束优于自由预设主题色板和固定组件保证输出质量样式粘贴不掉全内联样式 文字节点包裹质量靠脚本不靠自觉双关卡确定性检查换模型不走样排版逻辑沉淀在组件库中Agent友好输入输出都是纯文本适配各种AI助手 注意事项不适合的场景gzh-design-skill专注于公众号排版不适合以下场景普通网页/落地页使用前端skillPPT制作使用PPT skill纯图片海报/社交卡片非公众号平台的排版代写文章只排版不写作平台限制已内置所有公众号平台的限制都已内置到校验脚本中包括禁用标签style、script、div等禁用属性class、id禁用样式position: fixed/absolute/sticky、float等禁用功能media、keyframes、CSS变量等 效果预览项目提供了完整的主题预览你可以在docs/gallery/目录中查看6套主题的实际效果。每个主题都展示了完整的排版组件包括标题和章节编号正文和关键词标记引用块和引言卡片代码块和图片作者签名区域 获取帮助如果你在使用过程中遇到问题先运行校验脚本检查错误参考references/eval-cases.md中的示例查看项目文档和FAQ如果仍有问题可以查看项目源码或提交Issuegzh-design-skill的设计理念是让公众号排版变得简单可靠。通过预设的主题组件库和严格的校验机制确保每次生成的HTML都能完美适配公众号平台。无论你是排版新手还是经验丰富的内容创作者这个工具都能帮助你节省大量排版时间专注于内容创作本身。记住好的排版不应该成为创作的负担而应该是内容的加分项。让gzh-design-skill帮你处理技术细节你只需要专注于写出精彩的内容✨【免费下载链接】gzh-design-skill把 Markdown 一键排成可直接粘进公众号编辑器的精致 HTML —— 6 套精选主题 主题生成器 双关卡校验。An AI-agent skill that turns Markdown into paste-ready WeChat article HTML.项目地址: https://gitcode.com/gh_mirrors/gz/gzh-design-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考