md2wechat

name	md2wechat
description	Converts Markdown to WeChat Official Account HTML using AI-themed layouts and optionally one-click publishes to the draft box. Use when formatting Markdown for WeChat or uploading drafts with WECHAT_APPID/WECHAT_SECRET set in an env file.

MD to WeChat Skill (AI Only)

Convert Markdown to WeChat Official Account HTML with inline CSS (AI mode) and optionally upload to the draft box.

Quick Commands

# Render AI-style HTML (theme) from Markdown
python scripts/md_ai_render.py --md article.md --theme autumn-warm --out article.html

# Then publish
python scripts/wechat_publish.py --md article.md --html article.html --draft --cover cover.jpg

---

Workflow

1. Read the Markdown file and note title, images, and structure.
2. Pick AI theme (see references/themes.md).
3. Render themed HTML and save it to file.
4. If user wants one-click publish, upload images and create draft with the tool.

Render HTML

python scripts/md_ai_render.py --md article.md --theme autumn-warm --out article.html

Draft Upload (One-Click Publish)

python scripts/wechat_publish.py --md article.md --html article.html --draft --cover cover.jpg

Use the first image as cover if the user does not provide one.

Fetch WeChat-Sanitized HTML

python scripts/wechat_publish.py --md article.md --html article.html --draft --cover cover.jpg --fetch-draft article.wechat.html

Images

• Local/remote images are uploaded to WeChat by the tool during publish.
• For AI-generated images, insert ![alt](__generate:prompt__) in Markdown or ask in natural language.
• For details, read references/image-syntax.md.

Standalone Image

AI image generation is handled by Claude; no separate tool call.

Configuration (Env File)

Assume the user has an env file (e.g. .env) configured with:

• WECHAT_APPID
• WECHAT_SECRET

Optional:

• IMAGE_API_KEY (AI images)
• IMAGE_API_BASE

The publish tool loads .env by default; override with --env. It also accepts AppID/AppSecret in the env file. Draft title defaults to the Markdown filename (without .md). Override with --title.

Examples

Example 1: Basic Conversion

Input (article.md):

# Hello World

This is a simple article.

- Item 1
- Item 2

Command:

python scripts/md_ai_render.py --md article.md --theme autumn-warm --out article.html

Output (article.html): WeChat-compatible HTML with inline CSS and autumn-warm theme styling.

Example 2: Publish to Draft

Input: article.md + article.html + cover.jpg

Command:

python scripts/wechat_publish.py --md article.md --html article.html --draft --cover cover.jpg

Output:

{"success": true, "image_count": 2, "draft_media_id": "xxx"}

References

• references/themes.md (AI themes and prompts)
• references/html-guide.md (WeChat HTML rules)
• references/image-syntax.md (image syntax)
• references/wechat-api.md (draft upload behavior)