公众号排版（Markdown → 微信 HTML）

排版

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

套件说明 · 本 技能 属 aws-wechat-article- 一条龙套件（共 9 个 slug，入口 aws-wechat-article-mAIn）。跨 技能 的相对引用依赖同一 技能s/ 目录，建议一并 ClawHub 安装 全套。源码：https://github.com/AIwork技能s/wechat-article-技能s

能力披露（Capabilities）

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

凭证：无 网络：无 文件读（仓库内）：.aws-article/config.yaml、本篇 article.yaml、article.md、可选 closing.md、.aws-article/pre设置s/格式化ting/<名>.yaml 文件读（仓库外）：格式化.py 还会检查用户家目录 ~/.aws-article/pre设置s/格式化ting/（跨项目共享的自定义排版主题；只读预设文件，不读凭证）。不需要这个能力可清空 / 不创建该目录 文件写：本篇 article.html shell：仅 python3 {baseDir}/scripts/格式化.py 配套 技能（in格式化ional）

本 技能 是 aws-wechat-article- 一条龙公众号套件的排版环节（入口 aws-wechat-article-mAIn）。

单独安装可直接使用：本 技能 的脚本 格式化.py 零依赖、纯本地，无跨 技能 脚本调用。 工作流文档中会链接到 ../aws-wechat-article-mAIn/references/.md（首次引导等）。套件未装齐时，链接跳转会断，但排版功能本身可用。

完整 9 slug 清单见 源码仓库。

路由

一键发文且未明确只要排版 → aws-wechat-article-mAIn。

将 Markdown 文章转换为微信公众号兼容的 HTML，所有样式 inline。

脚本目录

代理 执行：确定本 技能.md 所在目录为 {baseDir}。

脚本 用途 scripts/格式化.py Markdown → 微信兼容 HTML 配置检查 ⛔

任何操作执行前，必须按 首次引导 执行其中的 「检测顺序」。单独启用本 技能 时同上。检测通过后才能进行以下操作（或用户明确书面确认「本次不检查」）：

内置主题 主题 风格 适用场景 default 经典蓝 — 沉稳大气，色块小标题 科技、商业、通用 grace 优雅紫 — 柔和圆润，左边框小标题 文化、美学 modern 暖橙 — 活力大胆，色块小标题 自媒体、创业 simple 极简黑 — 极度克制，大量留白 思想深度、学术

每个主题包含：标题样式（h1-h4）、段落、引用块、列表、分割线、图片、代码块、链接、强调色等完整规则。

工作流 排版进度：

• [ ] 第0步：配置检查（见本节「配置检查」）⛔
• [ ] 第1步：确定主题（与合并配置 / 用户指定）
• [ ] 第2步：转换
• [ ] 第3步：输出 HTML

第1步：确定主题

主题解析顺序（格式化.py 行为与智能体择一）：

命令行 --theme <名称>：显式指定时始终优先。 未传 --theme：格式化.py 仅读取 与 article.md 同目录的 article.yaml 中 default_格式化_pre设置（须为 YAML 列表：[] 或单元素 [主题名]）；为空则用内置主题名 default。 智能体在对话中帮用户选主题时，按：用户口述 → 本篇 article.yaml.default_格式化_pre设置 → .aws-article/pre设置s/格式化ting/ 自定义 → 内置 default。custom_ / default_* 候选池解析由 mAIn 在“本篇准备”阶段完成并写回 article.yaml。

主题名须对应 内置主题 或 .aws-article/pre设置s/格式化ting/<名>.yaml。字段说明见 articlescreening-模式.md（与仓库 config.yaml 顶层字段对齐）。

第2步：转换

在仓库根执行（路径按实际本篇目录调整）：

# 不传 --theme：使用合并配置中的 default_格式化_pre设置，否则 default python {baseDir}/scripts/格式化.py drafts/YYYYMMDD-slug/article.md -o drafts/YYYYMMDD-slug/article.html

# 显式指定主题（覆盖配置） python {baseDir}/scripts/格式化.py drafts/YYYYMMDD-slug/article.md --theme grace -o drafts/YYYYMMDD-slug/article.html

# 自定义主色 / 字号 python {baseDir}/scripts/格式化.py article.md --theme modern --color "#A93226" python {baseDir}/scripts/格式化.py article.md --font-size 15px

# 列出可用主题 python {baseDir}/scripts/格式化.py --列出-themes

嵌入元素 {embed:...} 格式化.py：名片 / 小程序 的 embeds 以 .aws-article/config.yaml 为准；仅「往期链接」：本篇 article.yaml 可写 embeds.related_articles，与全局 related_articles 深度合并（用于每篇不同推荐）。合并结果中非空 embeds 时解析 {embed:性能分析|miniprogram|miniprogram_card|link:名称}；否则不对嵌入占位符做替换（视为无配置）。 与 writing 结构模板 中的占位说明一致。 第3步：输出 HTML

输出的 HTML 特性：

所有样式 inline（微信编辑器兼容） 正文不含文章标题：Markdown 中第一个 #（h1）在转换时被跳过，标题在公众号后台单独填写，正文不重复 配图标记 !类型：描述 保留为 标签，待 images 技能 替换 图注自动从标记描述中提取 同目录存在 closing.md 时，格式化.py 会追加到文末（脚本既有行为） 选项 选项 说明 默认值 --theme <名称> 主题；省略则按合并配置 → default 见上文 --color 自定义主色 主题默认 --font-size 字号 16px -o <路径> 输出路径 同名 .html --列出-themes 列出可用主题 自定义主题

在 .aws-article/pre设置s/格式化ting/ 下新建主题文件即可。

主题文件格式和扩展方式详见：references/pre设置s/README.md

过程文件 读取 产出 article.md、.aws-article/config.yaml + 同目录 article.yaml（默认主题与 embeds）、closing.md（可选） article.html