# AWS Wechat Article Formatting

公众号排版｜Markdown 转 HTML｜排版主题｜段落样式, 公众号一键排版工具，Markdown 文稿转微信后台可粘贴...

- Repository: https://github.com/aiworkskills/wechat-article-skills (721 stars)
- Category: DevOps
- License: Apache-2.0
- Last updated: 2026-09-23
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-formatting -g -a claude-code -y`
Codex: `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-formatting -g -a codex -y`
Cursor: `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-formatting -g -a cursor -y`
Gemini CLI: `npx skills add aiworkskills/wechat-article-skills --skill aws-wechat-article-formatting -g -a gemini-cli -y`

## Description

公众号排版｜Markdown 转 HTML｜排版主题｜段落样式, 公众号一键排版工具，Markdown 文稿转微信后台可粘贴 HTML，多主题、多字号、段落样式切换，所见即所得。面向公众号编辑、独立作者、排版岗。触发词：「排版」「版式」「美化」「格式化」「字号」「段落样式」「换个排版主题」「换个版式」「转 HTML」「弄好看点」「调整格式」。换预设包/品牌包/整套主题配色请走 aws-wechat-article-assets；需要多环节串联（写+审+排+配图+发）请走 aws-wechat-article-main。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 排版

**公众号一键排版**, , Markdown 转微信后台可粘贴 HTML，多主题、多字号、所见即所得。

> **套件说明** · 本 skill 属 `aws-wechat-article-*` 一条龙套件（共 9 个 slug，入口 `aws-wechat-article-main`）。跨 skill 的相对引用依赖同一 `skills/` 目录，建议一并 `clawhub install` 全套。源码：<https://github.com/aiworkskills/wechat-article-skills>

## 能力披露（Capabilities）

本 skill 为**纯本地** Markdown → HTML 转换，零网络、零凭证。

- **凭证**：无
- **网络**：无
- **文件读（仓库内）**：`.aws-article/config.yaml`、本篇 `article.yaml`、`article.md`、可选 `closing.md`、`.aws-article/presets/formatting/<名>.yaml`
- **文件读（仓库外）**：`~/.aws-article/presets/formatting/`（跨项目共享的自定义主题；**只读预设文件，不读凭证**）
- **文件写**：本篇 `article.html`
- **shell**：仅 `{python} {baseDir}/scripts/format.py`

**单独安装可直接使用**：`format.py` 零依赖、纯本地，无跨 skill 脚本调用。文档里指向 `../aws-wechat-article-main/references/*.md` 的链接在套件未装齐时会断，但排版功能本身可用。

## 路由

一键发文且未明确只要排版 → [aws-wechat-article-main](../aws-wechat-article-main/SKILL.md)。

## 配置检查 ⛔

任何操作前先按 **[首次引导 · 检测顺序](../aws-wechat-article-main/references/first-time-setup.md)** 执行，通过后才继续（或用户明确书面确认「本次不检查」）。单独启用本 skill 时同样。

## 内置模版

排版 = **模版**（骨架：标题装饰、导语、金句卡、图片处理、分隔、文末）× **配色**（一组主色/次色，派生色自动重算）。名字即用途，选之前先看「适合」：

| 模版 | 适合 | 不适合 | 配色（第一个是默认） |
|------|------|--------|---------|
| `亲和` | 教程、职场、面向新手的解释性长文 | 严肃议题、极简冷硬的品牌 | 黛紫 / 松绿 / 靛蓝 |
| `资讯` | 快讯、评测、行业观察 | 抒情散文、碎片化短段 | 墨绿 / 绛红 / 藏青 |
| `书卷` | 人文、读书、历史、深度长文 | 工程文档、数据密集的评测 | 朱砂 / 黛蓝 / 苍绿 |
| `杂志` | 品牌故事、人物访谈、生活方式 | 没有配图的稿子、信息型短文 | 石青 / 驼褐 / 铁锈 |

**不传 `--theme` 时的内置默认是 `亲和`。**

另外四套不随 skill 内置，在 aiworkskills.cn 选好模版和配色后随 `.aws` 预设包下发到 `.aws-article/presets/formatting/`（见 [assets skill](../aws-wechat-article-assets/SKILL.md)）：`活力`（产品发布、增长复盘）、`手账`（个人笔记、复盘）、`硬朗`（观点、宣言）、`技术`（工程实践、代码讲解）。网站上选的配色会烘进 YAML 顶层 `variables`，落地后不需要额外配置。

**选之前先跑一次**，判据、色值、每套配色的口径都在输出里，别只按名字猜：

```bash
{python} {baseDir}/scripts/format.py --list-themes
```

**说不清就看**：`--preview` 把样张渲成并列对照页（每栏 375px，与真机同宽），用浏览器打开。

The rest: https://github.com/aiworkskills/wechat-article-skills/blob/HEAD/skills/aws-wechat-article-formatting/SKILL.md