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
themevalues. - The theme ids are used by the
convertendpoint. - 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.cnis 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
| Group | Count | Example ids |
|---|---|---|
| Built-in (原生主题) | 6 | default, bytedance, apple, sports, chinese, cyber |
| Classic (经典精选) | 2 | wechat-native, nyt-classic |
| Modern (潮流精选) | 4 | github-readme, sspai-red, mint-fresh, sunset-amber |
| Extra (更多风格) | 4 | ink-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
- Browse /themes to narrow the catalog by scenario.
- Open md2wechat.cn for deeper visual review of the same theme family. If needed, use the backup editor domain md2wechat.app.
- Pass the final
themeid into Convert. - If you still need access, continue to Contact.