wechat-pack

Convert local .docx or Markdown files into WeChat-ready HTML and generate a publish folder (source/assets/cover/wechat). Use when packaging documents for WeC...

Quick start

Run from the skill root:

./wechat_pack path/to/article.docx
./wechat_pack path/to/article.md

Outputs a publish folder with:

• source/ original input file
• assets/ downloaded or extracted images
• cover/ optional cover image
• wechat/ article.html ready to paste into WeChat editor
• meta.json metadata (title, paths, asset count, cover variants)

Supported inputs

• .docx (requires pandoc installed)
• .md / .markdown
• .html / .htm (treated as already-converted HTML)

Recommended workflow

1. Export the document from your editor to .docx or .md.
2. Run ./wechat_pack <file>.
3. Open wechat/article.html and paste into the WeChat editor.

Options

• --out <dir>: output directory (default: <basename>-wechat)
• --title <title>: insert a top-level title if missing
• --cover <path-or-url>: download or copy a cover image into cover/

Notes

• For .docx conversion, pandoc must be available in PATH.
• The script downloads external images and rewrites <img> to local assets/ paths.
• Output HTML is styled with inline CSS to be friendly to the WeChat editor.
• If Pillow is available, cover variants are generated in cover/: cover-wide-2.35x1.jpg and cover-square-1x1.jpg.