md2wechat Agent API markAgent API Docs
md2wechat Agent API markAgent API Docs
Homepage

Start

Markdown to WeChat API DocsQuickstartAuth

APIs

Integrations

Operations

ErrorsPricingContact
X (Twitter)

Theme

How the `theme` parameter maps to the md2wechat theme catalog and editor.

Theme

theme is the parameter that tells md2wechat Agent API which WeChat style to use when it converts Markdown or creates reviewable drafts.

What this page means

  • The public catalog at /themes matches the currently supported theme values.
  • The theme ids are used by the convert endpoint.
  • md2wechat.com is the official site and docs portal.
  • md2wechat.cn is the editor entry for deeper visual inspection of the same themes.
  • If md2wechat.cn is unavailable, the editor backup domain is md2wechat.app.

How to choose a theme

Pick a theme based on:

  • content type: knowledge, product, feature, brand, or operations
  • reading rhythm: lighter vs denser layouts
  • contrast level: softer vs stronger visual emphasis
  • review workflow: whether the article will be copied manually or turned into a draft

Start from /themes, filter by scenario, then keep the chosen theme id in your API request.

Example

{
  "markdown": "# Hello\n\nBody",
  "theme": "default",
  "fontSize": "medium",
  "backgroundType": "default"
}

The 48 themes, grouped

GroupCountExample ids
Built-in (原生主题)6default, bytedance, apple, sports, chinese, cyber
Classic (经典精选)2wechat-native, nyt-classic
Modern (潮流精选)4github-readme, sspai-red, mint-fresh, sunset-amber
Extra (更多风格)4ink-minimal, lavender-dream, coffee-house, bauhaus-primary
Template (模板主题)32{minimal,focus,elegant,bold}-{gold,green,blue,orange,red,navy,gray,sky} such as elegant-gold

Mode matching

Themes carry a type of api or ai. API mode selects only api themes and AI mode selects only ai themes — the loader fails closed on a mismatch (THEME_MODE_MISMATCH).

Per-theme metadata

Each theme carries semantic metadata: bestFor (content scenarios), mood, density (light/balanced/dense), and contrast (soft/medium/strong). Use these fields to shortlist before previewing.

Recommended path

  1. Browse /themes to narrow the catalog by scenario.
  2. Open md2wechat.cn for deeper visual review of the same theme family. If needed, use the backup editor domain md2wechat.app.
  3. Pass the final theme id into Convert.
  4. If you still need access, continue to Contact.

Table of Contents

Theme
What this page means
How to choose a theme
Example
The 48 themes, grouped
Mode matching
Per-theme metadata
Recommended path