用 Markdown 写 X 长文:@riba2534 的 Chrome 插件配合 xap 桥接,一键排成 X Article 草稿(附 Claude Code Skill)
X Article 编辑器不认粘贴进来的 Markdown,代码块、表格、公式要一个个从「插入」菜单加。中文作者 @riba2534 开源了 Markdown to X Article(MIT,Chrome MV3):侧边栏写 Markdown,一键写入 X 原生标题/列表/代码块/表格/LaTeX,Mermaid 本地渲染成图再上传;只创建草稿、从不自动发布。另附本地 xap 桥(127.0.0.1:17345)和 Claude Code Skill,Agent 可预检、建草稿。需要 Chrome 116+、已登录 X,且 X Article 要 Premium。我们在盒子上 npm ci 后跑 vitest:371 项里 368 过、2 跳过,1 项「200 KB 文档转换 <300ms」在本机约 757ms 超时失败;没有装 Chrome 扩展、也没连真 X 账号写草稿。
访问官网 Markdown to X Article (riba2534/x-article-post) ↗- 定价
- 免费
- 地区
- 海外
- 出自哪里
- 中文社区
- 上架日期
- 2026 年 11 月 4 日
- 实测日期
- 2026 年 11 月 4 日
- 用的版本
- x-article-post v1.0.64 (GitHub tag); package.json 1.0.0; vitest 5.0.5
- 我们实测
- 部分实测
- 成本 / 耗时
- 扩展与桥接开源免费。使用 X Article 功能需要 X Premium(或更高)订阅;Agent 路径另需本机 Node 22+。
要解决的事
把博客/技术笔记里的 Markdown(含代码、表格、公式、Mermaid、图片)排成 X Article 草稿,并可选让 Claude Code 通过本地桥接代建草稿,人再审阅发布。
步骤
- 从 GitHub Releases 下载最新扩展 zip(我们读到的标签为 v1.0.64),在 chrome://extensions 打开「开发者模式」→「加载已解压的扩展程序」。浏览器需 Chrome 116+,并已登录 x.com;发 X Article 需要 X Premium。
- 打开扩展侧边栏,粘贴或写入 Markdown;可选 front matter 的 title / featured_image。点「创建草稿」(或追加/替换当前草稿)。写入期间保持 X 标签页可见,图片多时可能要几分钟。
- 完成后点「打开草稿」检查。被降级的语法(如 H3+ 变粗体段落、超长代码拆分)会出现在报告里;确认无误后再在 X 里手动发布——扩展从不自动发。
- 给 Agent 用:本机 Node ≥22 运行 `node xap.mjs serve`(Release 里的 xap.mjs,或仓库内 `npm run bridge`),首次会生成 `~/.config/x-article-post/token`。侧边栏「设置 → Agent 桥接」打开,URL `ws://127.0.0.1:17345/ext`,Token 填 `xap token` 输出。
- 把 `skills/markdown-to-x-article` 拷到 `~/.claude/skills/`(或用 Release 的 skill zip)。Agent 先 `xap status` / `xap convert article.md` 预检,再 `xap draft article.md`;有外链图时先在设置里允许读取所有网站图片。
提示词
用 Markdown to X Article 把这篇笔记发成 X Article 草稿:先确认 xap 桥和扩展已连接,对文件跑 convert 把 warnings 用中文跟我讲清楚,等我确认后再 draft;只建草稿,不要尝试发布。笔记路径:./notes/post.md
原文怎么说
@riba2534:在 X 上发 Markdown 文章太痛苦,所以做了这个 Chrome 插件。原生排版(标题、列表、引用、链接、粗体斜体)、代码块语法高亮、表格与 LaTeX、Mermaid 本地渲染成高清图、图片自动下载转换上传、读标题和封面、发布前预览并列出降级语法;只生成草稿。带本地 API 和 Claude Code Skill,可让 Agent 建草稿。免费开源,MIT。
我们实测
克隆 riba2534/x-article-post(v1.0.64),npm ci 后执行 npm test(vitest)。阅读 README 与 skills/markdown-to-x-article/SKILL.md。未加载 Chrome 扩展、未启动 xap serve、未登录 X、未创建真实草稿。
我们亲自试下来:vitest:20 个文件中 18 通过、1 失败、1 跳过;测试 368 通过、1 失败、2 跳过。失败项为「200 KB 文档转换在时间预算内」(预算 300ms,本机第二次约 757ms)。其余转换/桥接相关单测通过。
怎么用上
GitHub Releases 下 zip;需能使用 Chrome 与 x.com。X Article 对国内账号同样要 Premium。原帖中文。
适合谁
经常把技术长文、教程发到 X Article 的人;想让 Claude Code 代建草稿、自己最后点发布的作者。
踩坑提示
- 没有 X Premium 就没有 Article 编辑器,插件帮不上忙。
- 写入时必须保持 X 标签页可见;外链图片要先开「允许读取所有网站图片」,否则 Agent 写入会跳过图片并进 warnings。
- H3+、脚注、部分 HTML 等会被降级,先看 convert 报告再 draft。
- 我们实测:vitest 368/371 通过,大文档性能断言在本盒子上未达标(约 757ms > 300ms 预算),功能测试其余通过;未在真 Chrome/X 上端到端写草稿。
同类用例
- 用真人范文代替禁词表,让 AI 写出你的语气写作文案open-writing-skillClaude CodeGemini开源免费;需自备范文和模型◐ 部分实测国内
- 先看上下文,再改掉机翻黑话编程开发clear-namingCodexClaude Code技能免费;无额外依赖◐ 部分实测国内
- 11 个 Skill 把个人资料长成可查知识库效率办公知识库Claude CodeWorkBuddy底座免费(BY-NC);Agent/飞书另计◐ 部分实测国内
- 一句话把 Agent 文稿排成可打印 PDF写作文案KamiClaude CodePDF技能免费;需编码 Agent 订阅◐ 部分实测国内
- 说一个选题,出一条每句有出处的知识短片视频创作Claude Code小米 MiMoRenoise基础档 0 积分;需 Claude 订阅◐ 部分实测国内