Communitygithub.com

zjp1997720/wechat-styler

將 Markdown 轉換為可直接貼入微信公眾號的內聯樣式 HTML。支援 10 種主題、確定性驗證與佔位符機制。

wechat-styler 是什麼?

WeChat Styler 是一款專為微信公眾號排版設計的 AI 技能,能將 Markdown 文章轉換為內聯樣式的 HTML,確保複製到公眾號編輯器後樣式不丟失。它內建 10 種精心設計的主題,從品牌風格(如 zhijian)到雜誌系列(如 magazine-ink/magazine-dune)以及優雅復古、現代簡約、極簡主義等,每種主題都綁定了獨特的渲染人格,控制字體、行距、顏色與版面結構。技能支援批量轉換(glob 模式)、自訂參數(如字型大小、強調色),並透過 `scripts/convert.mjs` 與 `scripts/validate.mjs` 實現確定性驗證,強制所有背景色使用 solid hex、禁止 `rgba()`、`<style>` 標籤與外部資源,避免公眾號編輯器貼上後樣式失效。此外,它提供佔位符機制(如 `【插入:xxx】`),讓作者在圖床尚未就緒時即能預覽排版,後續再替換為真實圖片。支援 Claude Code、Cursor 等 Agent 平台,以 `/wechat-styler` 指令操作,適合需要頻繁產出高品質公眾號內容的開發者與內容創作者。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add zjp1997720/wechat-styler

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

WeChat Styler 左右並列效果預覽
alt
圖片說明

說明文件

WeChat Styler - 公眾號排版工具

將 Markdown 文章轉換為優雅的公眾號 HTML 格式,支援多主題切換。

效果預覽

使用 2026-06-30 最近抓取的 WorkBuddy 真實文件節選生成,左側為原始 Markdown,右側為 zhijian 主題輸出。

WeChat Styler 左右並列效果預覽

使用方式

# 基礎用法(使用預設主題)
/wechat-styler path/to/article.md

# 指定主題
/wechat-styler path/to/article.md --theme kami
/wechat-styler path/to/article.md --theme magazine-ink

# 批量轉換(支援 glob 模式)
/wechat-styler "articles/*.md" --theme kami
/wechat-styler "01_專案/內容創作/**/*.md" --theme magazine-ink

# 自訂參數
/wechat-styler path/to/article.md --theme kami --font-size 17 --accent-color "#1B365D"

# 輸出到指定路徑(單一文件)
/wechat-styler path/to/article.md --output path/to/output.html

可用主題

0. zhijian(智見AI 品牌主題)- 預設主題

開源聲明:這是一個範例品牌主題,展示如何把一套品牌系統(顏色 + 字體 + 版式人格)固化進 skill。它來自作者自己的品牌設計系統。你可以直接用,也可以參考它的結構,把 themes/zhijian.yaml 改成你自己的品牌主題(換顏色、換字體、換 top_label)。

特點:

  • 基於 DESIGN.md 品牌系統,暖紙感 × 顧問可信度
  • 紙感背景 #F5F4ED,深暖陶行動色 #B85235,墨藍結構色 #1B365D
  • 三層字體策略:標題楷體(品牌感)、正文宋體(可讀性)、UI 黑體(功能性)
  • H2 左側暖陶豎線,H3 墨藍色,引用塊 Human Accent 左線
  • 程式碼塊暖黑底 12px 圓角,行內程式碼墨藍色淺藍底
  • 加粗和連結使用 #A04A2E(WCAG AA 安全暖色)
  • 分隔線使用暖陶色短線置中

適用場景: 所有智見AI品牌內容 — 公眾號文章、培訓講義、課程內容、方法論分享、AI 落地案例

參數:

font_family_cn: 'Source Han Serif SC','Noto Serif CJK SC','Songti SC',Georgia,serif
font_family_en: 'Georgia','Source Serif 4','Charter','Times New Roman',serif
font_size: 17
line_height: 1.58
accent_color: '#B85235'
accent_secondary: '#1B365D'
background_color: '#F5F4ED'
surface_color: '#FAF9F5'
text_color: '#141413'
heading_font: 'TsangerJinKai02','Source Han Serif SC','Noto Serif CJK SC','Songti SC',Georgia,serif
ui_font: 'Source Han Sans SC','Noto Sans CJK SC','PingFang SC',-apple-system,sans-serif
code_font: 'JetBrains Mono','SF Mono','Fira Code',Consolas,Monaco,'Source Han Serif SC',monospace
code_bg: '#30302E'
code_color: '#F5F4ED'

1. kami(紙感編輯排版)

特點:

  • warm parchment 紙感背景:#f5f4ed
  • ink-blue 單一強調色:#1B365D
  • 中文標題使用襯線/楷體棧,正文使用穩定無襯線棧
  • 溫暖灰階,不使用冷灰和純白大底
  • 標題左側藍色豎線、solid tag 背景、克制引用塊
  • 所有背景色使用 solid hex,並在外層、內容層、文本層重複宣告,降低貼上到公眾號後背景遺失風險

適用場景: 公眾號深度文章、商業分析、課程內容、正式說明文

參數:

font_family_cn: 'Inter','TsangerJinKai02','Source Han Sans SC','Noto Sans CJK SC','PingFang SC','Microsoft YaHei',Arial,sans-serif
font_family_en: 'Newsreader','Source Serif 4','Source Serif Pro','Charter',Georgia,'Times New Roman',serif
font_size: 16
line_height: 1.55
accent_color: '#1B365D'
background_color: '#f5f4ed'
surface_color: '#faf9f5'
text_color: '#141413'
secondary_color: '#5e5d59'
heading_font: 'TsangerJinKai02','Source Han Serif SC','Noto Serif CJK SC','Songti SC','STSong',Georgia,serif
code_font: 'JetBrains Mono','SF Mono','Fira Code',Consolas,Monaco,'TsangerJinKai02','Source Han Serif SC',monospace

2. magazine 系列(電子雜誌 × 電子墨水)

從 magazine-web-ppt 遷移來的 5 套預設,保留 ink / paper / tint 的雜誌色彩關係,同時改造成微信公眾號安全 HTML:不使用 rgba(),所有背景色均為 solid hex。

主題指令變體字體 / 版式人格
墨水經典--theme magazine-inkink-classic無襯線正文 + 襯線標題,細 rule、dash list、pull quote,通用雜誌內頁
靛藍瓷--theme magazine-indigoindigo-researchInter/SF Pro 正文 + Source Serif 標題,左側研究欄、note quote、技術程式碼塊
森林墨--theme magazine-forestforest-fieldnote楷體/宋體正文 + 非虛構標題,置中標題、field note 引用、自然圖片說明
牛皮紙--theme magazine-kraftkraft-archive宋體正文 + archive 標題盒,檔案式引用、羅馬數字有序列表、舊紙程式碼框
沙丘--theme magazine-dunedune-galleryAvenir 正文 + Didot/Bodoni 標題,右對齊畫廊標題、gallery quote、極簡圖片說明

共同特點:

  • 每個主題都有獨立字體棧、字型大小、行距、段距、標題結構、列表 marker、引用塊、程式碼塊和圖片說明。
  • 分隔以留白、短淡線和局部標識為主;不會在每個章節之間自動插入整寬實線。
  • 五個主題共享 magazine-editorial renderer 入口,但透過 magazine_variant 走不同結構分支,不只是替換顏色。
  • 所有背景色都使用 solid hex,並在區塊與文字 span 上重複宣告 background-color,降低複製到公眾號編輯器後背景色遺失的機率。
  • 圖片自身帶 margin:0 auto 置中兜底,避免公眾號編輯器複製後改寫圖片寬度導致圖片靠左。
  • 版式保留雜誌感,但輸出仍完全內聯,可直接複製到公眾號編輯器。

3. elegant(優雅復古)

特點:

  • 中文:方正書宋(FZShuSong-Z01)
  • 英文:Garamond
  • 整體淡灰色背景
  • 紅色強調色系統
  • 襯線標題 + 等寬程式碼

適用場景: 商業案例、深度分析、知識分享

參數:

font_family_cn: 'FZShuSong-Z01','Songti SC',STSong,serif
font_family_en: 'Garamond',serif
font_size: 16
line_height: 1.9
accent_color: '#cf4436'
background_color: '#f7f6f1'
heading_font: 'Noto Serif SC','Songti SC',STSong,Georgia,serif
code_font: 'JetBrains Mono','SF Mono',Menlo,Consolas,monospace

4. modern(現代簡約)

特點:

  • 無襯線字體
  • 純白背景
  • 藍色強調色
  • 清晰現代

適用場景: 科技產品、教學、快訊

參數:

font_family_cn: 'PingFang SC','Hiragino Sans GB','Microsoft YaHei',sans-serif
font_family_en: 'SF Pro Display','Helvetica Neue',sans-serif
font_size: 16
line_height: 1.8
accent_color: '#007aff'
background_color: '#ffffff'
heading_font: 'PingFang SC','Hiragino Sans GB',sans-serif
code_font: 'SF Mono',Menlo,Consolas,monospace

5. minimal(極簡主義)

特點:

  • 極簡黑白
  • 大量留白
  • 灰色調
  • 克制優雅

適用場景: 哲學思考、個人隨筆、藝術評論

參數:

font_family_cn: 'Noto Sans SC','PingFang SC',sans-serif
font_family_en: 'Inter','Helvetica Neue',sans-serif
font_size: 15
line_height: 2.0
accent_color: '#333333'
background_color: '#fafafa'
heading_font: 'Noto Sans SC',sans-serif
code_font: 'JetBrains Mono',monospace

Renderer Presets

主題不只換顏色。每個主題綁定一個 Markdown 渲染人格,負責標題、正文、引用、列表、程式碼、圖片說明的結構、字型大小、行高、間距和字重。

Preset綁定主題版式語氣
zhijian-warm-paperzhijian品牌講義:暖陶豎線標題、墨藍三級標題、Human Accent 引用、暖黑程式碼塊
kami-documentkami紙感文件:正式、克制、標題左側 ink-blue 豎線
magazine-editorialmagazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune電子雜誌家族:透過 magazine_variant 分別呈現 classic / research / fieldnote / archive / gallery 五種版式
elegant-essayelegant復古長文:置中標題、舒展行距、摘錄式引用
modern-technicalmodern現代教學:無襯線層級、提示卡片、技術程式碼塊
minimal-notesminimal極簡筆記:低裝飾、大留白、細線引用

公眾號相容硬規則: 所有 preset 輸出均為 inline style;背景色使用 solid hex;外層 section、內容 section、文字 span 會重複宣告 background-color。

主題參數說明

參數說明預設值
--theme主題名稱zhijian
--font-size正文字號(px)17
--line-height行高1.58
--accent-color強調色(標題、連結)#B85235
--background-color背景色,必須使用 solid hex#F5F4ED
--max-width內容最大寬度(px)640
--output輸出文件路徑自動產生

輸出規則

預設輸出路徑:

  • 輸入:path/to/article.md
  • 輸出:path/to/article_wechat.html

輸出內容:

  1. 完整的 HTML 文件
  2. 內聯樣式(可直接複製到公眾號)
  3. 保留圖片連結
  4. 自動處理程式碼塊、引用塊、列表等

工作流程

  1. 讀取 Markdown 文件

    • 解析 frontmatter(標題、摘要等)
    • 提取正文內容
  2. 載入主題配置

    • 讀取主題參數
    • 套用使用者自訂參數
  3. 轉換為 HTML

    • Markdown → HTML 結構
    • 套用主題樣式(內聯)
    • 處理特殊元素(程式碼、圖片、引用)
  4. 輸出文件

    • 產生完整 HTML
    • 儲存到指定路徑
    • 輸出使用說明

主題預覽

不確定選哪個主題?使用主題預覽產生器對比所有主題效果:

# 產生所有主題的預覽頁面(使用預設範例文章)
node scripts/generate-preview.mjs

# 使用自訂文章產生預覽
node scripts/generate-preview.mjs path/to/your-article.md

# 只預覽指定主題(逗號分隔,無空格)
node scripts/generate-preview.mjs article.md --themes magazine-ink,magazine-indigo,magazine-forest,magazine-kraft,magazine-dune

# 自訂輸出路徑
node scripts/generate-preview.mjs article.md --themes kami,elegant --output /path/to/my-preview.html

預覽頁面會並排展示所選主題的效果,方便快速對比選擇。產生的 preview.html 可以在瀏覽器中開啟檢視。

擴展新主題

步驟:

  1. 在 themes/ 目錄建立新主題配置檔案:

    # themes/my-theme.yaml
    name: my-theme
    description: 我的自訂主題
    font_family_cn: 'Custom Font CN'
    font_family_en: 'Custom Font EN'
    font_size: 16
    line_height: 1.8
    accent_color: '#ff6b6b'
    background_color: '#f8f9fa'
    heading_font: 'Heading Font'
    code_font: 'Code Font'
    
  2. 使用新主題:

    /wechat-styler article.md --theme my-theme
    

公眾號相容硬規則

以下規則由 scripts/validate.mjs 確定性執行,不依賴模型自覺。convert 產物自動校驗;獨立執行 node scripts/validate.mjs output.html 可複檢(0 ERROR 結束 0,有 ERROR 結束 1,給 CI/自動化使用)。

convert 採用軟門策略:發現 ERROR 時檔案照常產生(使用者能先看效果),結尾列印紅色報告明細;獨立 validate 腳本才回傳非零結束碼。

ERROR 級(產物必須為 0,否則貼上後會出問題)

  1. 禁用標籤:<style> / <script> / <link> / <iframe> / body 內 <meta> / <input>
    • 原因:公眾號編輯器剝離,導致樣式/腳本/外部資源失效
  2. 禁用屬性:class= / id= / contenteditable
    • 原因:公眾號編輯器剝離,樣式必須全部內聯到 style
  3. 禁用 CSS:position:fixed|absolute / display:grid|flex / @media / @keyframes
    • 原因:貼上後錯位、佈局崩塌或被忽略
  4. 禁用函式:rgba() / hsla()
    • 原因:背景色在編輯器中遺失,必須用 solid hex(如 #1B365D,非 rgba(27,54,93,0.8))
  5. 禁用外部字體:@font-face 的 url(...) 外部引用
    • 原因:載入失敗降級,版式走樣;用系統字體棧

WARN 級(建議修復,不阻斷)

  1. 圖片無 alt:<img> 缺 alt 屬性(無障礙 + 圖床失效時的兜底)
  2. 圖片偏移風險:<img> 缺 margin:0 auto 或 display:block(貼上後可能偏左)
  3. 區塊級元素缺 style:<p> / <h2> / <blockquote> 缺 style 屬性(貼上後樣式遺失)

convert.mjs 已內建的相容策略(無需手動處理)

  • 所有背景色使用 solid hex,不用 rgba()
  • 外層 section / 內容 section / 文字 span 三層重複宣告 background-color,降低貼上後背景遺失
  • 圖片父級 text-align:center + 自身 margin:0 auto;display:block 雙重兜底,防止偏移
  • 所有樣式內聯,不使用 <style> 標籤或外部 CSS

佔位符機制

寫作時圖床還沒準備好,但想先看排版效果?在 Markdown 裡寫佔位符,convert 會渲染成置中虛線灰框:

這是一段正文。

【插入:文章開頭的影片截圖】

繼續正文。

渲染效果:克制中性灰虛線框 + 置中灰字「📷 待補素材:xxx」,不搶正文視覺。圖準備好後,把 【插入:xxx】 替換成 ![alt](url) 即可。

只支援獨佔一行的 【插入:xxx】(全形方括號);行內不會觸發,避免誤傷正文。

範例

輸入 Markdown:

---
title: 文章標題
summary: 文章摘要
---

## 章節標題

這是一段正文,包含**加粗**和`程式碼`。

![圖片說明](https://example.com/image.png)

> 這是一段引用

輸出 HTML:

  • 完整的公眾號可用 HTML
  • 所有樣式內聯
  • 可直接複製貼上

技術實作

核心腳本: scripts/convert.mjs(轉換)+ scripts/validate.mjs(公眾號相容性校驗)

依賴:

  • Node.js 18+
  • marked(Markdown 解析)
  • js-yaml(YAML 解析)

目錄結構:

wechat-styler/
├── SKILL.md
├── scripts/
│   ├── convert.mjs          # Markdown → 公眾號 HTML(軟門呼叫 validate)
│   ├── validate.mjs         # 公眾號相容性校驗(獨立可執行 / 被 convert 引用)
│   └── generate-preview.mjs # 主題預覽頁產生器
├── themes/
│   ├── elegant.yaml
│   ├── kami.yaml
│   ├── magazine-dune.yaml
│   ├── magazine-forest.yaml
│   ├── magazine-indigo.yaml
│   ├── magazine-ink.yaml
│   ├── magazine-kraft.yaml
│   ├── modern.yaml
│   ├── minimal.yaml
│   └── zhijian.yaml
└── templates/
    └── base.html

最後更新: 2026-07-07 版本: 1.4.0 作者: 大鵬

相關技能