核心用法
aws-wechat-article-formatting 是微信内容生产工作流中的格式渲染引擎，负责将 Markdown 源文档转换为可直接粘贴至公众号后台的 HTML。通过 Python 脚本 format.py 实现全 inline 样式嵌入，规避微信编辑器对外部 CSS 的过滤。
典型调用场景：
python scripts/format.py article.md -o article.html --theme grace
- 主题系统：内置
default（经典蓝）、grace（优雅紫）、modern（暖橙）、simple（极简黑）四套预设，支持通过.aws-article/presets/formatting/自定义主题 - 配置解析层级：命令行
--theme> 同目录article.yaml的default_format_preset> 内置default - 嵌入占位符：支持
{embed:profile|miniprogram|link:名称}动态替换，依赖全局config.yaml与本篇article.yaml深度合并 - 智能适配：自动跳过 H1 标题（避免后台重复）、提取图注、追加
closing.md结尾模块
显著优点
1. 微信生态深度适配：所有样式 inline 化，100% 兼容公众号后台「粘贴-预览-群发」流程
2. 主题即插即用：无需懂 CSS，一键切换商业/文化/学术等多场景视觉风格
3. 配置驱动工作流：与 aws-wechat-article-* 套件共享 article.yaml 配置层，实现「写作-排版-分发」无缝衔接
4. 可扩展架构：自定义主题 YAML 与内置预设语法一致，支持主色、字号等参数覆盖
潜在缺点与局限性
- 依赖前置检查：必须完成「首次引导」中的配置检测，否则可能因 Python 环境或路径问题失败
- 嵌入元素耦合：名片/小程序等嵌入配置分散在全局
config.yaml与本篇article.yaml两处，合并逻辑复杂 - 图片分离处理：
仅保留标签，实际图床替换需配合aws-wechat-article-images执行 - 无实时预览：纯 CLI 工具，需手动粘贴到微信后台查看效果，调试成本较高
适合人群
- 自媒体运营者：需高频产出标准化排版内容的公众号作者
- 技术写作者：习惯 Markdown 写作、希望一键转微信格式的开发者
- 内容团队协作：采用
aws-wechat-article-*套件进行多人流水线生产的编辑团队
常规风险
- 配置漂移风险：
article.yaml未正确设置default_format_preset时可能回退到非预期主题 - 版本兼容风险：微信后台编辑器规则更新可能导致 inline 样式异常（需关注套件更新）
- 嵌入占位符泄露：
embeds配置缺失时，占位符原样输出，造成阅读体验瑕疵 - 安全意识：本 skill 处理的是本地文件转 HTML，无网络请求，但输出 HTML 若被二次编辑可能引入 XSS（建议粘贴前审查）