gzh-design

Convert Markdown articles into paste-ready HTML for the WeChat Official Account editor.

3.8k|419|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/isjiamu/gzh-design-skill --skill gzh-design-isjiamu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gzh-design
Source: https://github.com/isjiamu/gzh-design-skill
Command: npx skills add https://github.com/isjiamu/gzh-design-skill --skill gzh-design-isjiamu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? WeChat Official Account editors strip most HTML formatting on paste, so articles written in Markdown lose their styling when published. This Skill converts Markdown, Word, PDF, or plain-text drafts into fully inline-styled HTML fragments that survive pasting into the WeChat editor without losing layout. ## Core Features & Use Cases - Six curated theme libraries plus a theme generator: pick from Moyu Green, Red & White, Graphite Minimal, Zen Whitespace, Moyu Ticket, or Olive Journal, or generate a custom component library from a one-line description or reference image. - Smart layout automation: auto section numbering, per-paragraph keyword underlines, intro cards, table of contents, code blocks, image/GIF handling, and a merged author signature. - Deterministic quality gates: component_lint.py checks theme libraries for anti-patterns and validate_gzh_html.py verifies the final HTML against WeChat platform restrictions (no div/class/style tags, all text wrapped in span leaf). - Use Case: You finished a tutorial in Markdown and want to publish it on WeChat. Ask the agent to lay it out with the Moyu Green theme, then open the generated preview page, click the copy button, and paste directly into the WeChat editor. ## Quick Start Tell your agent: lay out article.md as WeChat HTML using the Moyu Green theme, then open the generated preview file and click the copy button to paste it into the WeChat editor.

Frequently Asked Questions about gzh-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to WeChat Official Account HTML?

Provide your Markdown file and choose a theme, and the skill assembles a fully inline-styled HTML fragment from the theme component library. Run validate_gzh_html.py on the output, then open the generated preview page and click the copy button to paste into the WeChat editor.

Why does formatting disappear when pasting HTML into the WeChat editor?

WeChat strips style tags, div elements, class and id attributes, CSS variables, grid layouts, and position properties. This skill avoids all of those by inlining every style and wrapping each text node in a span leaf element, which the validator script enforces deterministically.

Can I create a custom WeChat article theme?

Yes. Describe a style in one sentence or provide a reference image, and the theme generator produces a 45-75 block component library saved under assets/theme-previews. After confirmation it is converted into a standard theme file, registered in theme-index.md, and reused like a built-in theme.

Does it support Word or PDF documents as input?

Yes. Word .docx files are converted to Markdown by the extract_docx.py script, which preserves headings, bold text, lists, tables, and images. PDF files are read page by page with headers, footers, and hard line breaks cleaned before layout.

What are the limitations of this WeChat layout skill?

It only handles layout, not article writing, so you must bring finished content first. It is not suited for general web pages, landing pages, slide decks, image posters, or non-WeChat platforms, and output must remain a body fragment without html or head wrappers.