核心用法
aws-wechat-article-formatting 是微信公众号内容生产套件中的排版模块，专注解决 Markdown 到微信编辑器格式的转换痛点。用户只需提供 Markdown 文稿，即可通过 format.py 脚本输出微信后台可直接粘贴的 HTML，所有样式以内联形式写入，确保在微信生态内完美还原。
关键特性：
- 多主题切换：内置
default（经典蓝）、grace（优雅紫）、modern（暖橙）、simple（极简黑）四套预设，覆盖科技、文化、自媒体、学术等场景 - 灵活自定义：支持
--theme指定主题、--color自定义主色、--font-size调整字号，满足品牌个性化需求 - 智能嵌入：支持
{embed:...}占位符解析，自动替换名片、小程序、往期链接等元素 - 协作友好：与套件内 writing、images 等 skill 无缝衔接，配图占位符保留待替换，文末自动追加
closing.md结尾
显著优点
1. 零学习成本：纯命令行操作，无需理解微信 HTML 规范，Markdown 用户无缝迁移
2. 所见即所得：输出文件直接在浏览器预览，确认后再粘贴至公众号后台，避免反复调试
3. 配置继承机制：支持项目级 config.yaml 与个人级 article.yaml 层级合并，团队协作与个人偏好兼顾
4. 扩展性强：自定义主题仅需在 .aws-article/presets/formatting/ 下创建 YAML 文件，字段与官方 schema 对齐
潜在局限
- 强依赖套件生态：必须完整安装 9 个
aws-wechat-article-*skill 才能运行，单独使用会强制中断并提示安装 - 配置检查门槛：首次使用前需按
first-time-setup.md完成多环节检测，对急需出稿的场景不够友好 - 嵌入元素限制：小程序/名片配置依赖全局
config.yaml，仅「往期链接」支持单篇article.yaml覆盖，灵活性有限
适合人群
- 公众号编辑/排版岗位：批量处理多篇稿件，统一品牌视觉
- 独立作者/自媒体人：专注内容写作，一键搞定技术排版
- 内容团队协作：通过 Git 管理主题配置，确保多成员输出风格一致
常规风险
- 主题名拼写错误：自定义主题若文件名或 YAML 中
default_format_preset字段拼写有误，会回退至default主题且无明显报错 - 路径依赖问题：脚本需在仓库根目录执行，相对路径错误会导致
article.yaml读取失败 - 嵌入配置遗漏：
{embed:...}占位符若未在配置中声明，会原样保留在输出 HTML 中，需人工检查