微信公众号文章排版

将 Markdown 文章转换为微信公众号兼容的精美内联样式 HTML，支持30主题、AI内容增强、代码高亮及一键复制推送。

wechat-typeset-pro

微信公众号专业排版技能。把 Markdown 文章转为微信公众号兼容的精美内联样式 HTML，30 套主题 + 可视化画廊选择 + AI 内容增强 + 一键复制到公众号。可选推送到草稿箱。

Skill Description

微信公众号专业排版引擎：Markdown → 精美微信兼容 HTML。当用户说"排版""微信排版""公众号排版""format""美化文章"时使用。支持 30 套精美主题、可视化画廊预览、AI 内容结构增强、深色模式、代码高亮。

When to Use

• 用户需要将 Markdown 文章排版为微信公众号格式
• 用户说"排版""微信排版""美化""格式化为公众号格式""公众号排版"
• wechat-content-studio 技能的排版流程调用本技能
• 需要预览多种主题风格并选择最佳方案

脚本目录

{baseDir} = 本 SKILL.md 所在目录。

脚本	用途
scripts/format.py	排版引擎：Markdown → 微信兼容 HTML
scripts/publish.py	推送：HTML → 公众号草稿箱

配置

配置文件：{baseDir}/config.json

微信凭证优先从环境变量读取（~/.openclaw/.env），无需在 config.json 中配置敏感信息。

环境变量（自动从 ~/.openclaw/.env 加载）

变量	用途
WECHAT_APP_ID	微信公众号 AppID
WECHAT_APP_SECRET	微信公众号 AppSecret

Instructions

完整工作流

第 1 步：确认文章

1. 如果用户给了文件路径，直接读取
2. 如果没给路径，问用户要文章路径
3. 读取文章内容，确认标题和字数

第 1.5 步：结构化预处理（仅在需要时）

读取文章后，检测 Markdown 结构完整度。

判断规则：

• 有 ## 标题且格式标记分布合理 → 跳过，直接进入第 2 步
• 缺少 ## 标题或几乎没有格式标记 → 执行结构化

结构化规则（只加标记，不改内容）：

1. 识别逻辑段落插入 ## 标题（从内容提炼，不编造）
2. 确保段落之间有空行分隔
3. 识别并列内容加列表标记
4. 识别关键词加 **加粗**
5. 清理格式（多余空行、缩进、标点）
6. 不改措辞：不调语序、不增删内容

保存为 ~/WorkBuddy/wechat-typeset-pro/xxx-structured.md（与 config.json 的 output_dir，即 path.join(HOME, 'WorkBuddy', 'wechat-typeset-pro') 一致），告知用户。

第 2 步：AI 内容分析 + 自动套格式

分析内容结构，在 Markdown 层面自动套用排版容器：

1. 对话/访谈 → :::dialogue[标题]
2. 连续多图（3+） → :::gallery[标题]
3. 核心观点/金句 → > [!important] 标题（一篇 1-3 处）
4. 小技巧 → > [!tip] 标题
5. 注意事项 → > [!warning] 标题
6. 分隔符 → 章节转换处确保有 ---
7. 图说 → 图片后斜体：*图片说明*

保存增强后 Markdown 为 ~/WorkBuddy/wechat-typeset-pro/xxx-enhanced.md。

第 2.5 步：推荐主题

根据内容分析推荐 3 个最适合的主题：

内容类型	推荐主题
深度长文/分析	newspaper, magazine, ink
科技产品/AI工具	bytedance, github, sspai
访谈/对话体	terracotta, coffee-house, mint-fresh
教程/操作指南	github, sspai, bytedance
文艺/随笔/观点	terracotta, sunset-amber, lavender-dream
活力/动态/速报	sports, bauhaus, chinese

第 3 步：打开主题画廊（默认）

bash

python3 {baseDir}/scripts/format.py \
  --input "文章路径.md" \
  --gallery \
  --recommend newspaper magazine ink

用真实文章渲染 20 个主题，浏览器中选择。

第 3 步（备选）：直接指定主题

bash

python3 {baseDir}/scripts/format.py \
  --input "文章路径.md" \
  --theme terracotta

第 4 步：确认结果

• Gallery 模式：浏览器中切换主题，选中后点按钮复制，粘贴到公众号后台
• 直接模式：浏览器中检查预览，点「复制到微信」

推送到草稿箱（可选）

用户说"推送""发公众号"时执行：

bash

python3 {baseDir}/scripts/publish.py \
  --dir "排版输出目录" \
  --cover "封面图路径（可选）"

从 Markdown 直接推送：

bash

python3 {baseDir}/scripts/publish.py \
  --input "文章.md" \
  --theme terracotta

参数说明

format.py：

• --input / -i：Markdown 文件路径（必须）
• --gallery：打开主题画廊（推荐）
• --theme / -t：直接指定主题名
• --output / -o：输出目录（默认 ~/WorkBuddy/wechat-typeset-pro，即 path.join(HOME, 'WorkBuddy', 'wechat-typeset-pro')）
• --recommend：推荐主题 ID 列表
• --no-open：不自动打开浏览器
• --format：输出格式 wechat/html/plain

publish.py：

• --dir：排版输出目录
• --input：Markdown 文件路径（自动排版再推送）
• --cover / -c：封面图路径
• --title / -t：文章标题
• --theme：排版主题（仅 --input 模式有效）
• --author / -a：作者名
• --dry-run：只做排版，不推送

可用主题（30 个）

独立风格（9 个）

主题	ID	风格
赤陶	terracotta	暖橙色，满底圆角标题
字节蓝	bytedance	蓝青渐变，科技现代
中国风	chinese	朱砂红，古典雅致
报纸	newspaper	纽约时报风，严肃深度
GitHub	github	开发者风，浅色代码块
少数派	sspai	中文科技媒体红
包豪斯	bauhaus	红蓝黄三原色，先锋几何
墨韵	ink	纯黑水墨，极简留白
暗夜	midnight	深色底+霓虹色

精选风格（7 个）

主题	ID	风格
运动	sports	渐变色带，活力动感
薄荷	mint-fresh	薄荷绿，清爽
日落	sunset-amber	琥珀暖调
薰衣草	lavender-dream	紫色梦幻
咖啡	coffee-house	棕色暖调
微信原生	wechat-native	微信绿
杂志	magazine	超大留白，品质长文

模板系列（14 个）

4 种布局（Minimal / Focus / Elegant / Bold）× 多种配色（Gold / Blue / Red / Green / Navy / Gray）

内置排版增强

• CJK 间距修复：中英文/中数字之间自动加空格
• 加粗标点修复：**文字，** → **文字**，
• 纯内联样式：所有 CSS 写在 style="..." 上
• 列表模拟：<ul>/<ol> → <section> + flexbox
• 外链转脚注：自动变为正文标注 + 文末脚注
• 语法高亮：代码块自动着色 + Mac 风格工具栏
• 深色模式：自动生成微信深色模式 data-darkmode-* 属性
• 多类型 callout：tip/note/important/warning/caution 各有独立配色
• 图说识别：图片后斜体自动变居中灰色图说
• 对话气泡：:::dialogue 左右交替聊天气泡
• 图片画廊：:::gallery 横向滚动多图容器
• 时间线：:::timeline 时间线展示
• 步骤流程：:::steps 编号步骤
• 对比卡片：:::compare[A vs B] 两列对比
• 人物引言：:::quote[人名] 引言卡片
• 表格斑马纹：自动奇偶行背景色

容器语法

markdown

:::dialogue[采访实录]
Alice: 你好
Bob: 你好，很高兴认识你
:::

:::gallery[产品截图]
![](img1.jpg)
![](img2.jpg)
![](img3.jpg)
:::

:::timeline[发展历程]
2020: 项目启动
2022: 用户破百万
2024: 全球化
:::

:::steps[操作步骤]
打开设置页面
点击高级选项
开启开发者模式
:::

:::compare[方案 A vs 方案 B]
速度快 | 稳定性高
成本低 | 安全性强
:::

:::quote[乔布斯]
Stay hungry, stay foolish.
:::

> [!tip] 小技巧
> 选择适合文章风格的主题效果更佳

> [!important] 核心观点
> 这是文章的关键洞察