Turn X/Twitter bookmarks into local Markdown instantly.

中文 | English

这是一个完全本地运行的 Chrome 插件：

• 不调用任何 LLM API
• 不需要 API Key
• 没有模型调用费用
• 点收藏后自动保存 Markdown
• 自动下载帖子图片到本地 media/ 目录
• 在线程页会合并同作者连续跟帖
• 只保留原文，不做摘要改写

1. 打开 chrome://extensions/
2. 开启右上角「开发者模式」
3. 点击「加载已解压的扩展程序」
4. 选择本仓库根目录（包含 manifest.json）

1. 打开 https://x.com（或 https://twitter.com）
2. 点任意帖子的收藏按钮
3. 插件自动保存 Markdown，并下载该帖可提取的图片

默认保存路径：

• Downloads/x-bookmark-local/
• Downloads/x-bookmark-local/media/（图片）

• 不请求外部 AI 服务
• 不上传收藏内容到第三方
• 仅使用浏览器本地能力生成并保存文件

A fully local Chrome extension that saves bookmarked posts from X/Twitter to Markdown instantly.

• No LLM API calls
• No API key required
• Zero model/token cost
• Bookmark → save Markdown immediately
• Auto-download post images to local media/ folder
• On thread pages, merges consecutive same-author posts
• Original content only (no summary, no rewriting)

1. Open chrome://extensions/
2. Enable Developer mode
3. Click Load unpacked
4. Select the repository root (the folder containing manifest.json)

1. Open https://x.com (or https://twitter.com)
2. Click bookmark on any post
3. The extension auto-saves a Markdown file (images are optional)

Default output directory:

• Markdown: Downloads/x-bookmark-local/
• Images: disabled by default; if enabled, saved under Downloads/x-bookmark-local/media/

Optional image download:

1. Open the extension popup
2. Turn on Download images
3. (Optional) choose Image layout:
   • media/ subfolder
   • same folder as markdown

Custom output directory (new):

1. Open the extension popup
2. Set Download directory (relative to Downloads)
3. Click Save directory

Example: my-notes/x-bookmarks

• Markdown: Downloads/my-notes/x-bookmarks/
• Images: Downloads/my-notes/x-bookmarks/media/

Single-folder mode (new):

1. Open the extension popup
2. Set Image layout to Save images next to markdown (single folder)
3. New saves will place .md and image files in the same folder

Absolute folder mode (Native helper):

1. Open popup -> click Download Installer
2. Run Downloads/install-xbls-native-host.ps1 in PowerShell
3. Restart Chrome/Edge
4. Open popup -> click Choose Folder
5. From now on, files are written directly to that folder (not limited to Downloads)

• No external AI request
• No third-party upload of your bookmarked content
• Markdown generation and file saving are local-only browser actions

MIT — see LICENSE.