Operate the md2wechat CLI to convert Markdown into WeChat Official Account HTML, including article preview, draft upload, image-post creation, cover generation, title suggestions, and writer-style drafting.
Tasks
Run md2wechat inspect on an article.md file and report the readiness targets and blockers found in the JSON output.
Discover available themes by running md2wechat themes list --json and select a compatible theme for API mode based on type and selectable fields.
Inputs
Markdown article files
Brand Profile located at ~/.config/md2wechat/brand.md
WeChat credentials (MD2WECHAT_API_KEY, API credentials, image-provider credentials)
Outputs
WeChat Official Account HTML
Local preview artifacts
Draft creation on WeChat
Title-generation prompt requests for a host Agent or external model
Image plan mode prompt intent via --plan --json
Limitations and checks
AI mode does not parse :::module syntax, so advanced layout modules will not render
title suggest --json does not call a model, upload, create drafts, or write back to Markdown
doctor --json is local-only and does not perform live authentication, upload images, or create drafts
config wechat-accounts is local-only and never prints WeChat secrets
preview --mode ai is degraded confirmation only and must not be treated as final AI-generated layout
Verify that convert --draft is not used for image-first posts; use create_image_post instead.
Ensure inspect --json was run with the same mode flags (e.g., --mode ai --custom-prompt) before trusting readiness for AI-mode conversions.
Confirm that the source Markdown file remains read-only and any generated formatted Markdown uses a temporary path like /tmp/md2wechat-format/<run-id>/article.formatted.md.