wechat-article

仓库: freeany/wechat-article
安装量: 47
排名: #15687

安装

npx skills add https://github.com/freeany/wechat-article --skill wechat-article

Convert Markdown articles to WeChat Official Account (微信公众号) compatible HTML format with themed styling and inline CSS. This skill handles the entire conversion process automatically using the md_to_wechat.py script.

Core capability: Transform standard Markdown → WeChat-compatible HTML with professional styling.

Workflow

Step 1: Identify User Request

Trigger this skill when user asks for:

  • Converting Markdown to WeChat format

  • "转换为微信公众号格式"

  • "生成微信文章"

  • "公众号排版"

  • Applying WeChat styling to articles

Step 2: Gather Required Information

Required:

  • Input Markdown file path (from user request or current directory)

ALWAYS Ask User for Theme Selection: Use AskUserQuestion tool to present theme options to the user interactively.

Present these 3 theme options:

| default | 专业蓝色 | 技术文章、教程、通用内容

| orange | 活力橙 | 运动、美食、娱乐、促销活动

| grid | 格子主题 | 带序号徽章、动画效果，支持清新绿/大气蓝配色

Exception: Skip theme selection if user explicitly specifies theme in request.

Important: If user selects "grid" theme, ask for color preference: -清新绿 (green) - #52c41a，适合生活方式、健康、环保

  • 大气蓝 (blue) - #007AFF，适合科技、商务、专业内容

Additional Options (ask if needed):

  • Article title for WeChat header (default: none)

  • Include WeChat header/footer (default: yes)

Step 3: Execute Conversion

Important: Always use the absolute path to the skill script:

python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py <input.md> [output.html] [options]

ALWAYS use --preview flag to open browser with copy button:

  • Basic conversion with browser preview (RECOMMENDED):
python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py input.md --theme <selected-theme> --preview
  • With title and browser preview:
python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py input.md --theme <theme> --title "<article-title>" --preview
  • Content only (no WeChat elements) with preview:
python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py input.md --theme <theme> --no-header-footer --preview

Note: The --preview flag will automatically open a browser page with:

  • Article preview

  • "复制 HTML 代码" button to copy the HTML

  • Instructions for pasting into WeChat editor

  • Visual preview of the styled article

Step 4: Present Results to User

Always:

  • Confirm conversion completed successfully

  • Show which theme was used

  • Show output file location

  • Display a preview of the generated HTML (first ~30 lines)

  • Remind user they can copy-paste the HTML into WeChat editor

Example Interactions

Example 1: Standard workflow with theme selection and browser preview

User: "把 article.md 转成微信公众号格式"

Claude: [Uses AskUserQuestion]
"请选择文章主题风格：
• default - 专业蓝色（技术文章、教程、通用内容）
• orange - 活力橙（运动、美食、娱乐、促销活动）
• grid - 格子主题（带序号徽章、动画效果，支持清新绿/大气蓝配色）"

User: [Selects] "grid"

Claude: [Uses AskUserQuestion]
"请选择格子主题配色：
• green - 清新绿 (#52c41a) - 生活方式、健康、环保
• blue - 大气蓝 (#007AFF) - 科技、商务、专业内容"

User: [Selects] "blue"

Claude: [Executes] python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py article.md --theme grid --grid-color blue --preview
Claude: ✅ 使用格子主题（大气蓝）转换成功！浏览器已打开预览页面，点击"复制 HTML 代码"按钮即可复制到微信公众号编辑器。

Example 2: User specifies theme directly

User: "转换成微信公众号文章，用默认主题"

Claude: [Skips theme selection, user already specified]
Claude: [Executes] python3 ~/.claude/skills/wechat-article/scripts/md_to_wechat.py article.md --theme default --preview
Claude: ✅ 使用专业蓝色主题转换成功！浏览器已打开预览页面。

Implementation Notes

Available Themes

The skill currently includes 3 themes:

  • default (专业蓝色) - Professional blue theme

Primary color: #1e6bb8

  • Best for: Technical articles, tutorials, general content

  • orange (活力橙) - Vibrant orange theme

Primary color: #e67e22

  • Best for: Sports, food, entertainment, promotions

  • grid (格子主题) - Grid theme with number badges and animations

Default color: #52c41a (fresh green)

  • Alternative color: #007AFF (atmospheric blue)

  • Features: Numbered heading badges, rotation animations, auto list nesting

  • Best for: All content types, choose color based on topic

Green: Lifestyle, health, environmental topics

  • Blue: Technology, business, professional content

Dependencies

The script requires:

  • markdown>=3.5.0 - Markdown parsing

  • beautifulsoup4>=4.12.0 - HTML processing

  • pygments>=2.16.0 - Code syntax highlighting

Check if dependencies are installed before running. If not, install:

pip3 install markdown beautifulsoup4 pygments

Troubleshooting

Issue: Dependencies not found Solution: Install with pip3 install markdown beautifulsoup4 pygments

Issue: Script not found Solution: Use absolute path: ~/.claude/skills/wechat-article/scripts/md_to_wechat.py

Issue: WeChat styles not appearing Solution: Ensure user copies the entire HTML content including inline styles

Resources

scripts/md_to_wechat.py

Main conversion script. Execute with appropriate arguments based on user request.

references/themes.md

Detailed theme specifications. Consult when helping user understand theme differences.

assets/examples/sample.md

Example article demonstrating all supported features. Use for testing or showing user capabilities.

← 返回排行榜