API Overview

md2wechat Agent API exposes one public endpoint for the Markdown to WeChat HTML path.

Public endpoint

• POST https://www.md2wechat.cn/api/convert (backup domain: https://md2wechat.app)

Request fields: markdown (required), theme, fontSize, backgroundType. Auth is a single API key via one of three equivalent headers. See Auth.

Publishing and capabilities

• Publishing API — draft creation as a separate service, driven by the CLI
• WeChat IP Whitelist — when side effects need a whitelist, and the fixed egress
• Multi-Account Publishing — named accounts and explicit selection
• Image Generation — providers, presets, and plan mode
• Title Generation — the title suggest handoff
• Cover Image — explicit covers for every draft
• Layout Module Catalog — the 56-name advanced layout catalog

Shared rules

• Prefer curl or server-side fetch.
• Keep credentials server-side.
• Start with Auth.
• Choose a supported theme value from the theme catalog.
• Read Theme before wiring theme into convert.

If you want advanced layout

The more important shift is not just the endpoint list. convert can now take structured advanced layout modules as part of the Markdown input.

Recommended reading order:

1. Advanced Layout
2. Advanced Layout Syntax
3. Advanced Layout Recipes

Those three pages answer three different questions:

• why this syntax is worth adopting
• how the fields and modules should be written
• which small set of modules an agent should choose for a given content job

If you want the cleaner adoption path, continue with:

1. Mode Selection
2. Advanced Layout Use Cases
3. Discovery-First Workflow