Markdown to WeChat Publisher HTML

The Problem It Solves

Publishing Markdown content to WeChat Official Accounts presents a specific formatting challenge: the WeChat editor requires all CSS styles to be inlined directly into HTML tags. A straightforward copy-paste from a rendered Markdown preview loses all styling, while manually writing inline CSS is tedious, error-prone, and hard to maintain. This is especially cumbersome for content with code blocks, tables, or specific layout requirements.

How The Skill Works

This skill provides a lightweight Node.js script to automate the entire conversion from Markdown to "paste-ready WeChat HTML." Its core capabilities and key steps are:

• Automated Conversion & Inlining: The script processes an input .md file and a specified CSS theme file (e.g., resources/themes/default.css). It generates HTML from Markdown and automatically inlines all the CSS styles into each HTML element, satisfying WeChat's requirements.
• WeChat-Specific Adaptation: The script automatically wraps the output in a WeChat container (<section id="nice">...</section>) for better compatibility within the editor. It also processes CSS variables defined in the theme to allow for shared color schemes across multiple themes.
• Zero-Configuration Dependencies: When executed, the script loads all required dependencies into a temporary directory, performs the conversion, and then cleans up completely. The user only needs Node.js installed in their environment; there is no need to run npm install beforehand, enabling a true "out-of-the-box" experience.
• Theming Support: "Skin switching" is straightforward by simply changing the path of the CSS file passed to the script (files located in resources/themes/), allowing for different visual styles with minimal effort.

Scope and Important Notes

• Theme Variables: The current theme system uses CSS variables (e.g., --text-color). If you later use this output with other publishing tools (like zhy-wechat-publish) to upload to WeChat drafts, ensure the tool can expand these variables before upload to prevent style loss.
• Runtime Environment: Although the script handles dependencies automatically, the execution environment must have Node.js installed.
• Content Preview & Publishing: The generated HTML file can be opened directly in a browser to preview the final layout. To publish, you must select all content in the browser page and copy-paste it into the WeChat Official Account rich text editor.
• Input Source: This skill processes standard Markdown text. The input must be a .md file.