Title Generation

Command

md2wechat title suggest article.md --json

Flags: --target-reader, --count (8-10, default 10), --max-title-chars (default 25), --hook-level 1|2|3 (restrained / punchy / high_tension), --prompt (default wechat-title-expert).

How it works

Title suggestion is a host-agent handoff, not local generation:

• Returns TITLE_SUGGEST_REQUEST_READY with status: action_required
• execution_owner: host_agent — the host agent's model runs the bundled prompt
• recommendation_only: true — no side effects, nothing is written
• The bundled wechat-title-expert prompt scores candidates with the formula: 好标题 = 好奇缺口 × 价值预期 × 情绪驱动力 − 失望风险
• Output is 8-10 candidates across at least 4 strategies, with at least 2 direct-value titles

Hook levels

• 1 restrained — factual, low tension
• 2 punchy — stronger pull, still honest
• 3 high_tension — maximum curiosity gap, use with care

Applying the final title

md2wechat convert article.md --preview --title "Your final title"

WeChat enforces a 32-character limit on titles; the final title can also come from frontmatter.

Related

• Convert
• Cover Image