Markdown to WeChat Official Account Format & One-Click Publishing

Quick Start

Dependency Installation

# Format conversion dependencies
pip install markdown pygments beautifulsoup4

# One-click publishing dependencies (optional, required only for publishing)
pip install requests

# Better default cover image (optional)
pip install Pillow

Format Conversion (Single Article)

python ~/.cursor/skills/md-to-wechat/scripts/convert.py input.md

input.md

-o output.html

{input}_wechat.html

--theme

blue

green

dark

warm

blue

--dir

Batch Conversion (Entire Directory)

# Convert all .md files in the directory
python ~/.cursor/skills/md-to-wechat/scripts/convert.py --dir ./articles

# Batch conversion with specified theme
python ~/.cursor/skills/md-to-wechat/scripts/convert.py --dir ./articles --theme green

One-Click Publishing - Configuration (First Use)

# First use: configure AppID and AppSecret
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --setup

1. Go to Official Account Backend → Settings & Development → Basic Configuration
2. Get AppID and AppSecret
3. Add your local IP to the IP Whitelist

One-Click Publishing (Single Article)

# Create draft (recommended, check and publish manually in official account backend)
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md

# Create draft and publish directly
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md --publish

# Specify title, author and cover image
python ~/.cursor/skills/md-to-wechat/scripts/publish.py input.md --title "Article Title" --author "Author" --thumb cover.jpg

Batch Publishing (Entire Directory)

# Batch create drafts
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles

# Batch create drafts and publish
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles --publish

# Batch operation with custom interval (default 60s)
python ~/.cursor/skills/md-to-wechat/scripts/publish.py --dir ./articles --delay 30

--setup

--publish

--title

--author

--thumb

--theme

blue

--dir

--delay

60

Usage Workflow

Method 1: Preview + Manual Paste

1. Execute the conversion command to generate HTML file
2. Open the generated HTML file with a browser
3. Click the "Copy content to clipboard" button at the top of the page
4. Paste with

   Ctrl+V

   in the WeChat Official Account backend editor

Method 2: One-Click Draft Creation via API (Recommended)

1. Run

   --setup

   to configure credentials for first use
2. Execute the publishing command, the script will automatically create a draft
3. Go to the official account backend to check the draft content, then manually send it after confirmation

Method 3: One-Click Publishing via API

1. Run

   --setup

   to configure credentials for first use
2. Execute the

   --publish

   command, the script will automatically create a draft and publish it
3. Note: Articles published via API will not be pushed to followers, please manually send them in the backend if needed

Available Themes

• blue (Elegant Blue): Blue-themed, professional and concise, suitable for technical/business articles
• green (Fresh Green): Green-themed, natural and fresh, suitable for life/science popularization articles
• dark (Classic Black): Black-themed, calm and grand, suitable for in-depth/academic articles
• warm (Warm Orange): Orange-themed, lively and warm, suitable for marketing/story articles

Supported Markdown Elements

• Headings (h1-h4) with decorative styles
• Paragraphs with justified alignment
• Bold, italic, strikethrough
• Ordered/unordered lists, including nested lists
• Code blocks (with syntax highlighting and language tags)
• Inline code
• Tables (with zebra stripes)
• Blockquotes
• Horizontal rules
• Images (centered and adaptive, automatically uploaded to WeChat material library)
• Footnotes
• Task lists

Notes

• WeChat editor does not support external link jumps, links will be displayed as underlined text
• When using one-click publishing, external images in the article will be automatically uploaded to WeChat material library
• In manual paste mode, images need to be uploaded to WeChat material library first
• All styles are inline CSS to ensure complete retention in WeChat editor
• Code blocks will automatically scroll horizontally on mobile devices
• First-time publishing requires configuring AppID/AppSecret and adding IP to whitelist
• access_token is valid for 2 hours, the script will automatically cache and refresh it
• Articles published via API will not appear in followers' subscription messages, manual sending is required
• Starting from July 2025, publishing interface permissions will be revoked for personal accounts/unverified accounts