如何用 Claude Skill 将 Markdown 图文无痛发布 X Premium 文章？

你有没有过这种崩溃的时刻？

在 Obsidian 或者 VS Code 里，你行云流水地写完了一篇洋洋洒洒的 Markdown 文章。逻辑通顺，配图完美，甚至连代码块都高亮得恰到好处。你满怀期待地按下 Cmd+C，打开 X (Twitter) 的 Articles 页面，按下 Cmd+V。

然后，悲剧发生了。

所有的标题变成了普通文本，精心标注的加粗消失了，代码块乱作一团。你不得不叹一口气，把鼠标变成了「缝纫机」——选中标题，点击 H1；选中重点，点击加粗；遇到链接，还得一个个重新复制粘贴。

最绝望的是图片。如果你的文章里有 10 张图，在 X Articles 里意味着你要点击「添加媒体」-「选择文件」-「等待上传」整整 10 次。如果你想把图片精准地插在某两段文字中间，还得在编辑器里小心翼翼地滚动寻找光标位置。

因为 X 编辑器默认你在这里是码字。如果出现图，也应该是在它专门提供插图的地方插入。

而在文章当中，出现图的概率「应该并不高」，所以你遇到有图片地方再插入就好。

可惜我的风格不是这样的。我一般喜欢做教程，教程里的图可能是写几个段落就得用一张图作为佐证或者说明。这样的话，我一篇文章最多可能有 40 多张图。

一篇高质量的长文，写作可能只花了 1 小时，但在这个「格式化地狱」里排版，可能就要耗掉你好几十分钟，且被编辑器搞得心烦意乱。这不仅仅是时间的浪费，更是对创作心流的粗暴打断。

为了解决这个问题，我写了一个 Claude Skill 工具：

。

它不搞虚头巴脑的「黑科技」，只做一件事：把你的 Markdown 稿件，完美地「填」进 X 的编辑器里。

在这个工具的帮助下，流程变成了这样：

你只需要对着 Claude 说一句：「把这篇文章发布到 X」，然后给出 markdown 文件链接即可。

接下来的几分钟里，你可以喝口水，看着屏幕上的浏览器自动打开，封面图自动上传，标题自动填写。最神奇的是，它会像变魔术一样，瞬间把带有 H1、H2、粗体、链接、列表的富文本内容「注入」到编辑器中。

紧接着，它会根据你 Markdown 里的位置，精准地把每一张插图「塞」进对应的段落之间。

一切就绪后，它会停在「保存草稿」这一步。

从 20 分钟的机械劳动，到几分钟的自动化操作。这就是我想带给你的体验。

你可能会问，这背后的原理是什么？

首先，我们利用 Python 脚本，将你的 Markdown 解析并转换为 HTML 富文本，然后通过系统剪贴板，一次性将「骨架」注入编辑器。这样做的好处是，所有的格式（粗体、标题、链接）都能被 X 编辑器完美识别，而且速度极快，稳如泰山。

骨架搭好后，我们再利用 Playwright 自动化技术，像做填空题一样，通过锚点定位，把图片一张张精准地填入它们该去的位置。

这就是为什么它能兼顾速度与准确。

虽然这个工具能带来「10 倍效率」的提升，但我必须诚实地告诉你，它不是给所有人准备的。它有一定的使用门槛。

首先，它是一个「硬核玩家」的玩具。你需要准备好 Claude Code ，以及一些依赖库。当然了，如果 Claude Code 已经配置好，这些依赖库也可以喊 Claude Code 为你安装。

其次，它目前仅支持 macOS。因为我们在实现「剪贴板注入」这一核心功能时，使用了 pyobjc 库来调用 macOS 的底层接口。Windows 用户如果直接运行，会因为缺少这个库而报错。如果你是 Windows 上的 Python 高手，欢迎通过替换 pywin32 来帮我们完善它。

最后，默认前置条件，你需要是 X Premium Plus 订阅用户。因为只有这个级别的订阅，X 才开放 Articles（长文）功能。

如果你符合以上条件，那么恭喜你，你将获得一套极致的发布工作流。

如果你决定尝试，请按照以下步骤配置。

第一步：检查权限

确认你已经是 X Premium Plus 用户，并且在 Chrome 浏览器中已经登录了 X 账号。执行的时候它会开启一个新的 Chrome 窗口，你在这里面可能需要重新登录一遍。

第二步：安装 Claude Code

此处从略。

第三步：安装 Skill

你可以通过 Git 将工具克隆到本地，然后配置到你的 Claude 或其他 MCP 客户端中。

git clone https://github.com/wshuyi/x-article-publisher-skill.git
cp -r x-article-publisher-skill/skills/x-article-publisher ~/.claude/skills/

或者，你也可以使用插件市场。

/plugin marketplace add wshuyi/x-article-publisher-skill
/plugin install x-article-publisher@wshuyi/x-article-publisher-skill

第四步：开始发布

在 Claude 中，使用自然语言指令：

帮我把 ~/Documents/my-best-article.md 发布到 X。

然后，保持弹出的 Chrome 浏览器窗口可见（不要最小化），看着它自动替你完成那些枯燥的工作。

作为一个辅助工具，我必须向你明确它的边界。

第一，绝不自动发布。

工具的最后一步永远是「保存草稿」。为了安全起见，最终的检查权和发布按钮，必须掌握在人类（也就是你）的手中。你可以预览效果，确认无误后，再亲手点击发布。

第二，关于维护。

这是一个基于网页自动化（Playwright）的工具，它强依赖于 X 网页版的代码结构。如果下周 X 的前端工程师修改了一个 div 的类名，这个脚本可能就会失效。

请把它看作是一个实验性的项目。如果它报错了，请不要惊慌，欢迎在 GitHub 上提 Issue，或者自己（请 Claude Code ）动手修补它——毕竟，这才是极客精神所在，不是吗？

X Article Publisher Skill 的初衷，是践行 DRY (Don't Repeat Yourself) 原则。

在这个 AI 时代，我们的时间应该花在思考和创作上，而不是花在选中文字、点击加粗这种重复的一百次的机械操作上。

希望这个小工具，能帮你找回写作和分享的纯粹乐趣。

用 Claude Skill 自动发布 X 长文——DRY 原则的极客实践

核心观点

跟我们的关联

讨论引子

如何用 Claude Skill 将 Markdown 图文无痛发布 X Premium 文章？

相关笔记

🧭 主题 MOC

🎯 发布与分发：长文上线的前后链路

⚙️ 工具链：把 LLM 接进工作流

🔗 协作与维护：开源工具的迭代方式

⚔️ 反面视角：自动化的脆弱性与平台依赖

📋 讨论归档