md2wechat

Convert Markdown files into WeChat Official Account HTML.

3.5k|395|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/geekjourneyx/md2wechat-skill --skill md2wechat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md2wechat
Source: https://github.com/geekjourneyx/md2wechat-skill/tree/main/skills/md2wechat
Command: npx skills add https://github.com/geekjourneyx/md2wechat-skill --skill md2wechat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, wget, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of Markdown documents into WeChat Official Account HTML, eliminating tedious manual formatting and scattered steps when preparing posts and drafts. It supports API mode for fast conversions and AI mode for theming, and includes a writer-style assistant plus AI trace removal to ensure natural language output. It also integrates with WeChat draft upload to publish content directly from Markdown.

Core Features & Use Cases

  • API mode for quick, standards-compliant HTML conversion via md2wechat.cn
  • AI mode for themed, publication-ready layouts with inline CSS
  • Writer-style assistant and AI Humanizer to remove AI traces while preserving voice
  • Draft upload and image handling support for WeChat posts

Quick Start

Use the md2wechat Skill to convert a Markdown file into WeChat-ready HTML:

  • Preview (API mode): bash skills/md2wechat/scripts/run.sh convert article.md --preview
  • Preview (AI mode with theme): bash skills/md2wechat/scripts/run.sh convert article.md --mode ai --theme autumn-warm --preview
  • Upload to draft: bash skills/md2wechat/scripts/run.sh convert article.md --draft --cover cover.jpg

Frequently Asked Questions about md2wechat

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

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

To convert Markdown to WeChat HTML, use the API mode for fast, standards-compliant output via md2wechat.cn, or use AI mode for themed layouts. The tool applies inline CSS and WeChat-safe HTML to ensure your content renders correctly on the platform.

Do I need WeChat AppID and Secret to upload Markdown drafts?

Yes, uploading Markdown drafts to WeChat requires the WECHAT_APPID and WECHAT_SECRET environment variables. You must configure these credentials in your CLI workflow to authenticate and push converted HTML directly to your WeChat draft box.

What is the best way to format Markdown with themed layouts for WeChat?

The best way to apply themed layouts is using the AI mode, which generates publication-ready HTML with inline CSS. You can specify themes like 'autumn-warm' during conversion to automatically style your Markdown content for WeChat.

Can I remove AI traces from generated WeChat articles before publishing?

Yes, you can remove AI traces using the built-in AI Humanizer feature. This writer-style assistant processes your text to eliminate AI-generated patterns, ensuring the final WeChat article maintains a natural voice while preserving your original intent.

Does the WeChat Markdown converter support image upload and cover images?

Yes, the converter supports image handling and cover images for WeChat posts. You can include a cover image using the '--cover cover.jpg' flag during the draft upload process, and configure optional image API keys for processing inline images.

What dependencies are required to run the WeChat Markdown conversion CLI?

Running the WeChat Markdown conversion CLI requires curl and wget installed on your system. These dependencies are used by the Skill's scripts to handle network requests and file downloads during the HTML conversion and draft upload workflow.