Summary

This project, geekjourneyx/md2wechat-skill, addresses the common pain point of formatting and publishing articles to WeChat's official accounts. It allows users to write content in Markdown, a widely adopted plain-text format, and converts it into beautifully typeset HTML suitable for WeChat, automating the upload to draft posts. The tool targets content creators, product managers, and developers who find WeChat's native editor cumbersome, offering a streamlined workflow that simplifies article creation and publishing, akin to posting on social media.

How It Works

The core functionality revolves around converting Markdown files into WeChat-compatible HTML. Users can choose between two primary modes: an API mode that leverages the md2wechat.cn service for fast, standard formatting, and an AI mode that utilizes Claude AI to generate richer, more diverse, and aesthetically pleasing layouts with various themes. The workflow typically involves writing in Markdown, selecting a conversion mode and theme, previewing the output, optionally uploading associated images, and finally pushing the formatted article to the WeChat draft box. Advanced features include AI-assisted writing and AI-driven text "de-noising" to make AI-generated content sound more natural.

Quick Start & Requirements

Installation is straightforward, with pre-compiled binaries available for Windows, macOS (Intel and Apple Silicon), and Linux (amd64 and arm64). Alternatively, users can install via the Go toolchain, a provided installation script, or by compiling from source. Configuration requires WeChat Official Account credentials (AppID and Secret) for draft submission. The API mode necessitates an API key from md2wechat.cn, while the AI mode relies on Claude AI capabilities. Integration with Claude Code is supported via a plugin.

Highlighted Details

• AI Writing Assistance: The write command allows users to generate articles from simple ideas or outlines in various creator-defined styles (e.g., Dan Koe).
• AI De-noising: The humanize command refines AI-generated text to sound more natural and less robotic, with adjustable intensity.
• Themed Formatting: Supports multiple AI-generated themes (e.g., Autumn Warm, Spring Fresh, Ocean Calm) and API-based themes (e.g., bytedance, apple, sports).
• Image Handling: Includes capabilities for uploading single images, downloading from URLs, and AI-generated images (requires separate API configuration). Recommends 16:9 aspect ratio for optimal WeChat cover display.
• Claude Code Integration: Offers a seamless experience within Claude Code via natural language commands.

Maintenance & Community

The project is primarily maintained by geekjourneyx. Community interaction and support are facilitated through GitHub Issues. Links to the author's X (Twitter) and WeChat Official Account are provided for further engagement and updates.

Licensing & Compatibility

The project is released under the MIT License, which is permissive and allows for commercial use, modification, and distribution, including integration into closed-source projects.

Limitations & Caveats

The API mode is dependent on the availability and performance of the md2wechat.cn service and requires an API key. The AI mode relies on Claude AI, which may introduce higher latency (10-30 seconds) compared to the API mode. Users must possess valid WeChat Official Account API credentials (AppID and Secret) for the core functionality of sending drafts.