name: markdown-to-image description: Use when user wants to convert Markdown content into shareable image cards — triggered by phrases like "轉圖片"、"做卡片"、"生成海報"、"生成分享圖"、"把這個轉成圖片"、"export as image". Applies to any .md file or inline Markdown content destined for WeChat, Xiaohongshu, Weibo, or similar platforms.

Markdown → 圖片卡片

將 Markdown 渲染為多張精美圖片，適合社交平臺分享。

核心原則

不要詢問使用者任何引數。直接執行。

所有選項均有合理預設值；只有使用者主動提出才切換。

執行流程

步驟 0：預檢查（必須，在生成前執行）

讀取完整 Markdown 檔案，檢查以下問題：

技術問題 - ChatGPT 引用標記：檔案含 citeturnXviewY 或 Unicode 私用區字元（U+E000–U+F8FF） - 編碼異常、亂碼字元

內容問題 - 開頭有無關內容（如匯出說明、來源標註、平臺水印文字） - 結尾有無關內容（如參考文獻列表、腳註、版權宣告、"以上內容由AI生成"等） - 大段重複或明顯不適合做成卡片的內容

格式問題 - 標題層級混亂（如多個 H1、層級跳躍） - 表格格式錯誤

判斷規則： - 如果發現任何問題 → 向用戶列出問題摘要，詢問"是否修復後再生成？" - 如果檔案乾淨 → 直接進入步驟 1，不打擾使用者

修復 ChatGPT 引用標記的方法：

7w4.net收錄了海量優質技能外掛。

import re
with open('input.md', 'r', encoding='utf-8') as f:
    content = f.read()
cleaned = re.sub(r'cite(\w+)*', '', content)
cleaned = re.sub(r'[-]', '', cleaned)
cleaned = re.sub(r'cite\w+', '', cleaned)
with open('input_clean.md', 'w', encoding='utf-8') as f:
    f.write(cleaned)

步驟 1：確定標題

讀檔案前 30 行，理解主題，起 4-8 字書名式標題： - ✅ 摔PS5懲罰分析 / AI提問藝術 / AI時代兒童成長路線圖 - ❌ 心理學與教育學的專業共識認為母親用同態報

步驟 2：生成圖片（含封面標題卡）

node ~/.agents/skills/markdown-to-image/src/index.js \
  --markdown "/path/to/file.md" \
  --title "卡片標題" \
  --name "卡片標題"

--title 會生成封面卡（-00.png），內容卡從 -01.png 開始。

輸出自動寫入 ~/Downloads/<卡片名>/。

預設值（不傳即生效）

主題速查

頁碼格式

--page-format default    # 01, 02, 03
--page-format total      # 01 / 12, 02 / 12  ← 預設
--page-format brackets   # (1/12), (2/12)

常見錯誤

質量較好，核心功能完善，預檢查機制能有效避免生成失敗。兩套主題視覺效果不錯，圖片尺寸適合社交平臺分享。主要不足是生成速度依賴網路載入字型，且程式碼實現存在一些不一致可能影響穩定性。