WeChat Styler - 公眾號排版工具
將 Markdown 文章轉換為優雅的公眾號 HTML 格式,支援多主題切換。
效果預覽
使用 2026-06-30 最近抓取的 WorkBuddy 真實文件節選生成,左側為原始 Markdown,右側為 zhijian 主題輸出。

使用方式
# 基礎用法(使用預設主題)
/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-ink | ink-classic | 無襯線正文 + 襯線標題,細 rule、dash list、pull quote,通用雜誌內頁 |
| 靛藍瓷 | --theme magazine-indigo | indigo-research | Inter/SF Pro 正文 + Source Serif 標題,左側研究欄、note quote、技術程式碼塊 |
| 森林墨 | --theme magazine-forest | forest-fieldnote | 楷體/宋體正文 + 非虛構標題,置中標題、field note 引用、自然圖片說明 |
| 牛皮紙 | --theme magazine-kraft | kraft-archive | 宋體正文 + archive 標題盒,檔案式引用、羅馬數字有序列表、舊紙程式碼框 |
| 沙丘 | --theme magazine-dune | dune-gallery | Avenir 正文 + Didot/Bodoni 標題,右對齊畫廊標題、gallery quote、極簡圖片說明 |
共同特點:
- 每個主題都有獨立字體棧、字型大小、行距、段距、標題結構、列表 marker、引用塊、程式碼塊和圖片說明。
- 分隔以留白、短淡線和局部標識為主;不會在每個章節之間自動插入整寬實線。
- 五個主題共享
magazine-editorialrenderer 入口,但透過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-paper | zhijian | 品牌講義:暖陶豎線標題、墨藍三級標題、Human Accent 引用、暖黑程式碼塊 |
kami-document | kami | 紙感文件:正式、克制、標題左側 ink-blue 豎線 |
magazine-editorial | magazine-ink / magazine-indigo / magazine-forest / magazine-kraft / magazine-dune | 電子雜誌家族:透過 magazine_variant 分別呈現 classic / research / fieldnote / archive / gallery 五種版式 |
elegant-essay | elegant | 復古長文:置中標題、舒展行距、摘錄式引用 |
modern-technical | modern | 現代教學:無襯線層級、提示卡片、技術程式碼塊 |
minimal-notes | minimal | 極簡筆記:低裝飾、大留白、細線引用 |
公眾號相容硬規則: 所有 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
輸出內容:
- 完整的 HTML 文件
- 內聯樣式(可直接複製到公眾號)
- 保留圖片連結
- 自動處理程式碼塊、引用塊、列表等
工作流程
-
讀取 Markdown 文件
- 解析 frontmatter(標題、摘要等)
- 提取正文內容
-
載入主題配置
- 讀取主題參數
- 套用使用者自訂參數
-
轉換為 HTML
- Markdown → HTML 結構
- 套用主題樣式(內聯)
- 處理特殊元素(程式碼、圖片、引用)
-
輸出文件
- 產生完整 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 可以在瀏覽器中開啟檢視。
擴展新主題
步驟:
-
在
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' -
使用新主題:
/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,否則貼上後會出問題)
- 禁用標籤:
<style>/<script>/<link>/<iframe>/ body 內<meta>/<input>- 原因:公眾號編輯器剝離,導致樣式/腳本/外部資源失效
- 禁用屬性:
class=/id=/contenteditable- 原因:公眾號編輯器剝離,樣式必須全部內聯到
style
- 原因:公眾號編輯器剝離,樣式必須全部內聯到
- 禁用 CSS:
position:fixed|absolute/display:grid|flex/@media/@keyframes- 原因:貼上後錯位、佈局崩塌或被忽略
- 禁用函式:
rgba()/hsla()- 原因:背景色在編輯器中遺失,必須用 solid hex(如
#1B365D,非rgba(27,54,93,0.8))
- 原因:背景色在編輯器中遺失,必須用 solid hex(如
- 禁用外部字體:
@font-face的url(...)外部引用- 原因:載入失敗降級,版式走樣;用系統字體棧
WARN 級(建議修復,不阻斷)
- 圖片無 alt:
<img>缺alt屬性(無障礙 + 圖床失效時的兜底) - 圖片偏移風險:
<img>缺margin:0 auto或display:block(貼上後可能偏左) - 區塊級元素缺 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】 替換成  即可。
只支援獨佔一行的 【插入:xxx】(全形方括號);行內不會觸發,避免誤傷正文。
範例
輸入 Markdown:
---
title: 文章標題
summary: 文章摘要
---
## 章節標題
這是一段正文,包含**加粗**和`程式碼`。

> 這是一段引用
輸出 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 作者: 大鵬
