一键把 X/Twitter 🐦 书签、推文同步到 Obsidian
整理、备份你的推特知识库到本地 Vault，新增书签和推文会自动同步，无需二次点击
支持AI分类 · 长推文 · Thread · 文章 · 图片 · 视频
支持 Obsidian 桌面版（Mac / Windows / Linux），不支持手机端
为信息管理者打造的推特同步工具
稳定同步，零折腾，专注创作与复用。让 X/Twitter 推文沉淀为你 Obsidian Vault 的本地 Markdown。
AI 智能分类
支持 OpenAI、Gemini、DeepSeek、Qwen 等多种 AI 模型，自动为推文选择分类和标签，无需手动整理。需自备 API Key。
Obsidian 原生增量同步
设置一次，永久生效。Obsidian 插件后台定时检测新书签和新推文，增量同步到本地 Vault。
全类型推文支持
短推文、长推文 (Note Tweet)、Thread 串、X 文章，全部完整同步成 Markdown 笔记。
图片本地化 + 视频链接
推文图片自动下载到 Vault 的 Media 目录并嵌入引用；视频以链接形式保留。
智能标签处理
自动提取推文 Hashtag，去重优化，最多 3 个标签，写入 YAML frontmatter。支持 AI 自动打标签。
本地 Markdown + 元数据
每条推文一份 Markdown，YAML 包含作者 / @screenName / 链接 / 标签 / 创建时间，方便检索与双链。
4 步完成安装
Obsidian 原生插件，手动安装一次即可永久使用。
01.下载插件 zip
点击下载按钮获取 twitter2obsidian.zip 安装包。
下载 zip →02.解压到 Vault 插件目录
将 zip 解压到 <Vault>/.obsidian/plugins/twitter2obsidian/，确保目录下有 main.js、manifest.json、styles.css。
03.启用第三方插件
Obsidian 设置 → 第三方插件 → 关闭安全模式 → 点击刷新按钮，找到 Twitter Sync 并启用。
04.登录 X 开始同步
在插件设置中先填写授权码并点「验证」，再点「登录 Twitter/X」，弹窗内登录后点「登录完成，提取 Cookie」即可开始同步。
同步效果预览
看看 X/Twitter 推文是如何完整同步到 Obsidian Vault 的，保留所有重要信息。
书签 + 推文自动同步
书签和个人推文一键同步到 Obsidian Vault，增量自动同步无需操作。
Thread 完整同步
自动检测 Thread 串并完整抓取所有回复，合并为一份完整的 Markdown 笔记。
AI 自动分类 + 标签
支持 OpenAI、Gemini 等多种模型，自动为推文分类打标签。需自备 API Key。
一份授权码，Obsidian + Notion 双端通用
Notion 重度用户可以用同一份授权码激活 Notion 版插件，把 X/Twitter 推文同步到你的 Notion 工作区。
他们已在使用
看看其他用户是如何评价 Twitter2Obsidian 的同步效果。
“用 Twitter2Obsidian 同步了我所有的书签推文，终于不用担心推文被删除后找不到了。本地 Markdown 比云端更踏实，AI 分类还省掉了大量手动整理。”
“Thread 同步功能是我见过最好的，一个完整的 Thread 会被合并成一篇 Markdown 笔记，在 Obsidian 里阅读体验特别好。”
“作为一个重度 Twitter 用户，每天都会收藏大量推文。有了 Twitter2Obsidian，收藏的推文自动落地到 Vault，结合双链和搜索复用太方便了。”
“支持 X 文章同步真的很棒，长文内容完整保留为 Markdown，YAML 元数据和图片本地化做得很到位。”
常见问题
关于 Twitter2Obsidian 的常见问题解答。如果还有其他问题，可以联系我。
如何安装 Twitter2Obsidian 插件？
如何安装 Twitter2Obsidian 插件？
- 下载twitter2obsidian.zip安装包；
- 解压到
<Vault>/.obsidian/plugins/twitter2obsidian/，目录下应包含 main.js / manifest.json / styles.css； - Obsidian 设置 → 第三方插件 → 关闭安全模式 → 点击刷新按钮，找到 Twitter Sync 并启用；
- 在插件设置中先填写授权码并验证，再点「登录 Twitter/X」，弹窗内登录后点「登录完成，提取 Cookie」即可开始同步。
同步时提示「登录已失效」？
同步时提示「登录已失效」？
Twitter/X 的登录信息有有效期，过期后插件会自动检测并提示。点击设置中的「登录 Twitter/X」重新登录即可。
图片显示不出来？
图片显示不出来？
确认 Twitter/Media/ 目录下有对应的图片文件。如果没有，可能是下载失败，在插件设置中清除缓存重新同步即可。
想重新同步所有数据？
想重新同步所有数据？
在插件设置中点击「清除缓存并重新同步」按钮。这只会重置同步记录，不会删除已有的笔记文件（会覆盖更新）。
切换了 Twitter 账号怎么办？
切换了 Twitter 账号怎么办？
插件会自动检测账号切换并重置同步状态，无需手动操作。
同步间隔设多少合适？
同步间隔设多少合适？
建议 10 分钟以上，每批 20 条。Twitter 的频率限制相对宽松，但也不建议设太短。提示「请求频率限制」时，等几分钟会自动恢复，可以适当增大同步间隔。
提示「该授权码已绑定其他设备」？
提示「该授权码已绑定其他设备」？
授权码绑定单设备使用。如需更换设备，在原设备插件设置中点「解绑」后再到新设备上重新绑定即可。
如何更新插件？
如何更新插件？
下载新版本的 twitter2obsidian.zip，解压后覆盖 .obsidian/plugins/twitter2obsidian/ 目录下的文件，重新加载 Obsidian 即可。
如果我同时也用 Notion，能用同一份授权码吗？
如果我同时也用 Notion，能用同一份授权码吗？
可以。授权码在 Notion 版插件通用，Notion 重度用户可以在twitter.2notion.com下载推特同步到 Notion 的插件，用同一份授权码激活。
支持手机端 Obsidian 吗？
支持手机端 Obsidian 吗？
当前仅支持 Obsidian 桌面端（Mac / Windows / Linux），因为同步过程需要本地网络与文件系统能力。已同步的 Markdown / 媒体文件可在 Obsidian 移动端正常浏览。