核心用法
aws-wechat-article-formatting 是专为微信公众号内容生产设计的排版转换工具，核心功能是将 Markdown 格式的文章稿转换为微信编辑器兼容的 HTML 代码。用户通过命令行工具 format.py 执行转换，支持 --theme 指定主题、--color 自定义主色、--font-size 调整字号等参数，输出结果可直接粘贴至微信公众平台后台，无需二次调整。
工具采用 inline CSS 样式策略，确保微信编辑器完整保留设计效果；同时会自动跳过 Markdown 中的 h1 标题（因公众号后台需单独填写标题），并处理图片占位符、图注提取、文末结语追加等细节。
显著优点
1. 一键转换效率：省去手动调整微信编辑器格式的繁琐步骤，特别适合高频发文的内容团队
2. 多主题体系：内置 default（经典蓝）、grace（优雅紫）、modern（暖橙）、simple（极简黑）四种风格，覆盖科技、文化、自媒体、学术等多元场景
3. 配置灵活：支持通过 article.yaml 或命令行参数实现单篇文章的主题偏好，也支持自定义主题扩展
4. 套件协同：作为 9 个 slug 组成的 aws-wechat-article-* 套件之一，可与图片处理、发布等环节无缝衔接
潜在缺点与局限性
- 依赖本地 Python 环境：需要预先完成配置检查与依赖安装，对非技术用户有一定门槛
- 微信生态封闭性：inline CSS 虽兼容性好，但无法利用微信原生组件能力，交互性受限
- 主题定制需 YAML 知识：自定义主题需要理解预设文件结构，非可视化操作
- 版本维护成本：套件共 9 个 skill，需同步更新以避免跨 skill 引用失效
适合人群
公众号编辑者、独立内容作者、排版专职岗位、新媒体运营团队，尤其适合有固定发文节奏、追求视觉一致性、具备基础命令行操作能力的用户群体。
常规风险
- 配置检查疏漏：未执行首次引导检测可能导致转换失败或样式异常
- 主题名称拼写错误：自定义主题文件名与
--theme参数不匹配会回退到 default - 路径依赖问题：脚本依赖
{baseDir}定位，目录结构变更需同步调整 - HTML 粘贴兼容性：微信后台偶有更新，极端情况下可能需要微调输出代码