核心用法
aws-wechat-article-formatting 是一款面向微信公众号编辑的专业排版工具，核心功能是将 Markdown 文稿转换为微信后台可直接粘贴的 HTML 代码。用户通过命令行执行 format.py 脚本，指定主题、字号、配色等参数，即可生成所有样式内联的微信兼容 HTML。
典型工作流：
1. 配置检查 → 确认 9 件套依赖完整
2. 确定主题 → 内置 4 款主题（default/grace/modern/simple）或自定义 YAML 配置
3. 执行转换 → python format.py article.md -o article.html
4. 输出应用 → 直接粘贴至公众号编辑器
进阶特性：支持 --color 自定义主色、--font-size 调整字号、{embed:...} 占位符解析（名片/小程序/往期链接）、自动追加 closing.md 结尾、配图标记保留待 images skill 替换。
显著优点
- 即贴即用：所有 CSS inline，完美兼容微信编辑器，无需二次调整
- 主题丰富：4 款精心调教的内置主题覆盖科技、文化、自媒体、学术等场景
- 所见即所得：Markdown 写作体验，专业排版输出，分离内容与样式
- 高度可定制：支持 YAML 自定义主题，主色、字号、段落样式均可覆盖
- 套件协同：与 writing、images、publish 等 skill 无缝衔接，形成完整工作流
潜在缺点与局限性
- 依赖繁重：必须完整安装 9 件套才能运行，单 skill 无法独立工作
- 本地环境：需 Python 运行环境，对非技术用户有一定门槛
- 主题局限：内置仅 4 款主题，高度定制化需手写 YAML 配置
- 嵌入限制：名片/小程序配置依赖全局
config.yaml，单篇灵活性受限 - 无实时预览：命令行工具，需生成后粘贴至微信查看效果
适合人群
- 公众号编辑、排版岗位从业者
- 独立作者、自媒体创作者（技术向）
- 追求 Markdown 写作效率 + 专业排版输出的内容团队
- 有批量排版需求、需建立统一视觉风格的机构号运营者
常规风险
- 配置依赖风险：9 件套缺失会导致 workflow 中断，需严格按引导安装
- 版本兼容风险：微信后台规则更新可能导致 HTML 渲染异常，需持续维护
- 自定义主题风险：YAML 配置错误可能引发转换失败，建议先备份内置主题
- 嵌入元素失效：
{embed:...}若配置缺失会被保留为原文，需检查config.yaml - 标题重复问题：首个
#标题会被跳过，若需保留需在 Markdown 中重复书写