What is wechat-styler?

WeChat Styler is a developer tool that converts Markdown files into HTML that can be pasted directly into a WeChat Official Account article editor, keeping the formatting intact. Normally, pasting styled content into the WeChat editor breaks because it strips things like CSS classes, media queries, and certain style rules. This tool works around that by inlining every style directly into the HTML and using only techniques the editor actually supports. The project offers eight visual themes, each with its own distinct personality rather than just different colors. For example, one theme called magazine-ink follows a classic editorial newspaper look, while magazine-indigo uses uppercase headings for a research paper feel, and magazine-forest has a nature journal style with centered titles. Users can also turn on an optional set of six components, such as callouts, warnings, step lists, and comparison cards, for articles that need more structured presentation beyond plain paragraphs. A built in validation script checks the final HTML output against a list of things WeChat's editor is known to strip or break, such as style tags, class attributes, and fixed positioning, and prints a report showing exactly which lines have problems. This check runs automatically every time content is converted, so formatting mistakes are caught by code rather than relying on someone remembering the rules. The tool also supports placeholders: if an image is not ready yet, users can write a special marker line and it will show up as a dashed box in the output, to be swapped for a real image later. Under the hood, the project is organized into three scripts, one for conversion, one for the optional components, and one for validation, plus a set of YAML files that define each theme's fonts, colors, and spacing. Adding a new theme just means creating a new YAML file, with no code changes required. The tool requires Node.js version 18 or newer and is meant to be used as an agent skill inside tools like Codex or Claude Code, or run directly from the command line. It is released under the MIT license.