核心用法
本 skill 是 aws-wechat-article-* 公众号套件中的排版环节，专注 Markdown 到微信公众号兼容 HTML 的纯本地转换。用户通过 format.py 脚本将 article.md 转换为 article.html，输出文件所有样式 inline 处理，可直接粘贴至微信后台编辑器。
基础命令：
python {baseDir}/scripts/format.py drafts/YYYYMMDD-slug/article.md -o drafts/YYYYMMDD-slug/article.html支持 --theme 指定主题、--color 自定义主色、--font-size 调整字号。内置 4 套主题：default（经典蓝）、grace（优雅紫）、modern（暖橙）、simple（极简黑），覆盖科技、文化、自媒体、学术等场景。支持用户目录 ~/.aws-article/presets/formatting/ 下的自定义主题。
显著优点
1. 纯本地零依赖：无需网络、无需 API 凭证，单 Python 脚本运行，隐私内容不外泄
2. 微信深度兼容：所有 CSS inline 化，跳过 h1 标题避免与后台标题重复，图注、代码块、引用块均针对微信编辑器优化
3. 灵活配置层级：命令行参数 > 本篇 article.yaml > 全局 config.yaml > 内置 default，满足个人习惯与团队协作
4. 扩展性强：自定义主题仅需 YAML 文件，支持名片/小程序/往期文章等嵌入元素 {embed:...}
潜在缺点与局限性
- 功能单一：仅负责「排版」环节，不处理写作、配图、发布；需搭配套件其他 skill 完成全流程
- 无实时预览：转换后需手动粘贴到微信后台查看效果，非 WYSIWYG 编辑器
- 主题定制需技术基础：自定义主题需理解 YAML 结构与微信 CSS 限制
- 首次配置门槛：必须完成「配置检查」流程，对纯新手有一定学习成本
适合人群
- 公众号编辑、独立作者、排版岗位人员
- 对内容安全敏感、拒绝云端处理的团队
- 有固定排版风格、需要批量复用主题的用户
- 已在用 Markdown 写作、希望自动化公众号适配的技术写作者
常规风险
- 配置覆盖风险：命令行参数会覆盖文件配置，团队协作需明确约定优先级
- 自定义主题兼容性：自行编写的主题可能因微信编辑器更新而失效
- 嵌入元素依赖：
{embed:...}解析依赖全局config.yaml中的凭证配置，本 skill 虽不读取凭证，但嵌入功能可能因此受限 - HTML 输出需二次确认：建议每次粘贴到微信后台后检查移动端预览效果