X Articles 发布技能：自动化 Markdown 转 X 文章
X Articles 发布技能 – 一键将 Markdown 换成 X 文章
如果你在 Markdown 中撰写博客文章，可能曾试图将纯文本粘贴到 X（前称 Twitter）文章中，却遭遇格式丢失、手动上传图片和位置不确定等问题。X Articles 发布技能提供了一键自动化整个流程的解决方案：
- 解析 Markdown，提取标题、封面图片及所有嵌入图像。
- 将 Markdown 转成干净的 HTML，同时保留标题、链接、表格和 Mermaid 图表。
- 使用 Playwright（通过 Claude Code 框架）打开 X Articles 编辑器。
- 粘贴富文本内容。
- 按照 Markdown 指定的块索引精确插入图片，避免位置漂移。
- 将文章保存为草稿——防止意外发布。
最终得到一份格式完好、图片齐全、可提交审核的草稿，全部在 3 分钟内完成。
为什么你需要这个工具
喜爱 Markdown 的内容创作者在发布至 X Articles 时面临三大痛点：
- 格式丢失 – 粘贴纯 Markdown 会导致标题、列表、样式丢失。
- 图片上传耗时 – 每张图片都需手动浏览媒体菜单。
- 图片放置不可靠 – 手动拖拽或文本定位常导致内容错位。
该技能针对每个问题提供解决方案： - 富文本粘贴 通过剪贴板保留所有 Markdown 语义。 - 自动上传 采用智能等待检测，快速上传而无需手动点击。 - 块索引定位 保证图片出现在你预期的位置，即使在复杂文档中也不例外。
效率提升
对比典型工作量： | 任务 | 手动 | 使用技能 | |------|--------|-----------| | 格式转换 | 15‑20 分钟 | 0 分钟 | | 封面图片上传 | 1‑2 分钟 | < 10 秒 | | 多张内容图片 | 5‑10 分钟 | 1 分钟 | | 总计 | 20‑30 分钟 | 2‑3 分钟 |
这至少相当于提升十倍的生产力。
快速上手
前置条件
| 要求 | 说明 |
|---|---|
| Claude Code | 访问 https://claude.ai/code 进行安装 |
| Playwright MCP | 浏览器自动化驱动 |
| X Premium Plus | 文章功能仅对 Premium Plus 成员开放 |
| Python 3.9+ | 用于辅助脚本 |
| 操作系统 | macOS 或 Windows（Linux 正在支持中） |
| 剪贴板工具 | Windows: pip install Pillow pywin32 clip-util，macOS: pip install Pillow pyobjc-framework-Cocoa |
| Mermaid CLI | 可选，用于图表转换 (npm install -g @mermaid-js/mermaid-cli) |
安装
# 方式一：克隆仓库并复制至 Claude 技能目录
git clone https://github.com/wshuyi/x-article-publisher-skill.git
cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/
# 方式二：通过 Claude 插件市场安装
/plugin marketplace add wshuyi/x-article-publisher-skill
/plugin install x-article-publisher@wshuyi/x-article-publisher-skill
使用
技能可通过自然语言或直接命令调用。 - 自然语言（在 Claude 聊天中）
帮我把这篇文章发布到 X Articles：~/Documents/my-post.md
/x-article-publisher /path/to/article.md
工作流程：
1. 解析 Markdown 并提取元数据。
2. 在 x.com/compose/articles 打开 X Articles 编辑器。
3. 上传封面图并粘贴正文内容。
4. 使用块索引策略插入内容图像。
5. 保存草稿以备后续审核。
功能亮点
| 功能 | 版本 | 益处 |
|---|---|---|
| 分隔符支持 | v1.2.0 | 识别 --- 并通过“插入”菜单添加 X Articles 分隔符 |
| 表格转图片 | v1.2.0 | 将 Markdown 表格转换为 PNG 以保持视觉完整 |
| Mermaid 支持 | v1.2.0 | 使用 mmdc 将图表渲染为图片 |
| 块索引定位 | v1.1.0 | 直接定位图片位置，避免脆弱文本匹配 |
| 反向插入顺序 | v1.1.0 | 防止插入多张图片时索引偏移 |
| 自动等待策略 | v1.1.0 | 上传完成后立即返回，节省空闲时间 |
| 安全发布 | 每个版本 | 只保存草稿，防止误发布 |
贡献指南
本项目积极维护，欢迎提交 Pull Request。关键贡献点包括： - 增加 Linux 支持（剪贴板与 Playwright 配置）。 - 扩展图像格式支持（超出 JPG/PNG/GIF/WebP）。 - 改善错误处理（例如缺失图片路径）。 - 丰富文档，增加更多使用案例与高级示例。
请在 GitHub 仓库中提交 Issue 或 PR。
结论
X Articles 发布技能是 Markdown 写作者在 X Articles 发布时的终极工具。凭借自动化排版、精确图片放置和快速草稿工作流，它消除了拖放的烦恼，显著提升内容创作效率。无论你是单独博客作者、文案撰写者还是数字营销团队，该工具都能将文章生产周期压缩到十倍以上，并保障编辑安全。
立即尝试、Fork 并贡献改进——开源的繁荣源于协作！