X2MD

把 X/Twitter、LINUX DO、飞书、微信公众号内容一键保存为 Obsidian 可用的 Markdown。

教程导览图

适用场景

• 你会在 X/Twitter 上收藏大量信息，但链接回看效率低。
• 你希望把素材沉淀进 Obsidian，而不是散落在浏览器书签里。
• 你需要把 Thread / Note 长文转成可编辑 Markdown，用于二次创作。
• 你在 LINUX DO 论坛中看到值得收藏的帖子。
• 你在飞书知识库阅读团队文档，想要本地留档。
• 你在微信公众号看到好文章，想保存完整 Markdown 副本。

支持平台

平台	触发方式	说明
X / Twitter	点击书签按钮	支持 Tweet、Thread、Note/Article、图片和视频
LINUX DO	点赞 / 悬浮保存按钮	支持话题帖子内容
飞书	悬浮保存按钮	支持 wiki 知识库和 docx 云文档（自动滚动收集完整内容）
微信公众号	悬浮保存按钮	支持公众号文章（含图片、代码块、引用等）

3 分钟快速上手（推荐）

第 1 步：下载客户端（基于 GitHub Release）

• 打开 Releases
• 当前最新版本（截至 2026-05-01）：v1.0.9
• 下载对应平台包：
  • Mac: X2MD_Mac.zip
  • Windows: X2MD_Windows.zip
  • 扩展: X2MD_Extension.zip

第 2 步：首次运行并完成向导

1. 解压并运行 X2MD.app（Mac）或 X2MD.exe（Windows）。
2. 按向导设置：
   • Markdown 保存目录
   • 视频保存目录
3. 向导完成后，服务会在本地启动（默认 127.0.0.1:9527）。

第 3 步：安装 Chrome 扩展

1. 打开 chrome://extensions/
2. 开启“开发者模式”
3. 点击“加载已解压的扩展程序”
4. 选择解压后的 X2MD_Extension 目录，或本项目的 extension 目录

第 4 步：保存第一条内容

1. X / Twitter：打开任意推文页，点击推文操作区的书签按钮。
2. LINUX DO：打开话题页，点赞帖子或点击右上角悬浮 MD 按钮。
3. 飞书：打开 wiki 或 docx 页面，点击右上角悬浮 MD 按钮。
4. 微信公众号：打开公众号文章页，点击右上角悬浮 MD 按钮。
5. 扩展会将内容发送到本地服务并生成 Markdown。
6. 到你设置的目录查看 .md 文件。

第 5 步：在 Obsidian 中查看结果

• 生成内容默认包含 Front Matter。
• 图片会写入原图链接（name=orig）。
• 视频可配置为下载并写入 Obsidian 嵌入引用。

常用配置（进阶）

配置文件为根目录的 config.json，常用字段：

• save_paths: Markdown 输出目录列表
• filename_format: 文件名模板，支持 {summary} {date} {author}
• max_filename_length: 文件名长度上限
• video_save_path: 视频保存路径
• enable_video_download: 是否下载视频
• video_duration_threshold: 超长视频二次确认阈值（分钟）
• show_site_save_icon: 是否在支持的站点显示悬浮保存按钮

推荐模板示例：

{
  "filename_format": "{summary}_{date}_{author}",
  "max_filename_length": 60,
  "enable_video_download": true,
  "video_duration_threshold": 5
}

使用场景示意

场景 A：资料收藏

把高价值推文直接沉淀到素材库，避免后续失链或遗忘。

场景 B：内容创作

把 Thread / Note 转成 Markdown 后可快速摘录、改写、重组。

场景 C：知识库建设

统一命名与元数据，长期形成可检索、可关联的个人知识资产。

常见问题

1) 扩展提示“服务未启动”

• 确认桌面程序正在运行。
• 检查扩展端口与 config.json 中 port 一致。
• 访问 http://127.0.0.1:9527/ping，应返回 {"status":"ok"...}。

2) 保存成功但没有文件

• 检查 save_paths 是否存在写权限。
• 查看日志 x2md.log。

3) 视频没有下载

• 检查 enable_video_download 是否为 true。
• 视频超过阈值时会触发二次确认。
• 检查 video_save_path 是否可写。

本地开发与打包

安装依赖：

pip3 install -r requirements.txt

开发运行：

# 向导 + 托盘 + 服务
python3 tray_app.py

# 仅服务
python3 server.py

打包说明见 BUILD.md。 CI 工作流见 .github/workflows/build.yml。

项目结构

.
├── server.py               # 本地 HTTP 服务（/ping /config /save）
├── tray_app.py             # 桌面托盘入口
├── setup_wizard.py         # 首次配置向导
├── extension/              # Chrome 扩展（MV3）
│   ├── dom_utils.js        # 共享 DOM 工具函数
│   ├── article_markdown.js # X Article 富文本转 Markdown
│   ├── discourse.js        # LINUX DO 话题帖子提取
│   ├── feishu.js           # 飞书 wiki/docx block 解析
│   ├── wechat.js           # 微信公众号文章提取
│   ├── site_actions.js     # 站点识别与悬浮按钮配置
│   ├── content.js          # 内容脚本主入口
│   ├── background.js       # Service Worker（API 策略）
│   └── tests/              # Node.js 单元测试
├── BUILD.md                # 打包说明
└── docs/images/            # README 配图

更新日志

v1.0.9（2026-05-01）

• 基于 v1.0.8 代码线优化 X Article / 普通 Tweet 内嵌引用推文的 Markdown 排版
• 引用推文仅保留正文、图片和原文链接，不再混入回复/转帖/喜欢/浏览数或 Download 等操作信息
• 普通推文保存时会保留引用推文内容，并避免引用图片误混入主推图片列表
• 线程/评论里原作者回复他人时，自动去掉正文开头的 @账号，仅保留回复正文
• 修复引用推文图片过滤过宽导致 X Article 首图丢失的问题

v1.0.8（2026-03-24）

• 修复飞书虚拟渲染导致丢失 85% 内容的问题，新增滚动收集机制
• 补充飞书 iframe、table、base_refer、synced_source 等 block 类型
• 提取共享 DOM 工具函数到 dom_utils.js，消除 100+ 行重复代码
• 服务端：配置内存缓存、视频下载线程池限流、日志瘦身
• 打包：排除不必要模块减小 Mac 安装包体积

v1.0.7（2026-03-24）

• 新增微信公众号文章支持（mp.weixin.qq.com/s/*）
• 新增飞书知识库/云文档支持
• 新增 LINUX DO / 飞书 / 微信悬浮保存按钮
• 新增站点快捷保存开关

v1.0.6（2026-03-23）

• 修复 X 长文代码块语言标签未并入 Markdown fenced code block 的问题

GitHub 数据来源

• 仓库信息: https://api.github.com/repos/izscc/x2md
• 语言统计: https://api.github.com/repos/izscc/x2md/languages
• 最新发布: https://api.github.com/repos/izscc/x2md/releases/latest