把 X/Twitter、LINUX DO、飞书（知识库/云文档/聊天记录）、微信公众号内容一键保存为 Obsidian 可用的 Markdown。
致谢: 感谢 @AchengBusiness 提供 Windows 兼容性修复、多平台 Bug 修复、新功能与测试套件，这批改动已合并回主仓库。
- 你会在 X/Twitter 上收藏大量信息，但链接回看效率低。
- 你希望把素材沉淀进 Obsidian，而不是散落在浏览器书签里。
- 你需要把 Thread / Note 长文转成可编辑 Markdown，用于二次创作。
- 你在 LINUX DO 论坛中看到值得收藏的帖子。
- 你在飞书知识库阅读团队文档，想要本地留档。
- 你想把飞书网页版的聊天记录导出为 Markdown 存档。
- 你在微信公众号看到好文章，想保存完整 Markdown 副本。
| 平台 | 触发方式 | 说明 |
|---|---|---|
| X / Twitter | 点击书签按钮 | 支持 Tweet、Thread、Note/Article、图片和视频 |
| LINUX DO | 点赞 / 悬浮保存按钮 | 支持话题帖子内容 |
| Discourse（自定义域名） | 悬浮保存按钮 | 支持任意 Discourse 论坛（在选项页面配置域名） |
| 飞书文档 | 悬浮保存按钮 | 支持 wiki/docx/docs/sheets/mindnotes/minutes（自动滚动收集完整内容） |
| 飞书聊天记录 | 悬浮保存按钮 | 支持网页版 messenger 聊天记录导出（内部 API + DOM 双策略） |
| 微信公众号 | 悬浮保存按钮 | 支持公众号文章（含图片、代码块、引用等） |
- 打开 Releases
- 当前最新版本：
v1.6.0 - 下载对应平台包：
- Mac:
X2MD_Mac.zip - Windows:
X2MD_Windows.zip - 扩展:
X2MD_Extension.zip
- Mac:
- 解压并运行
X2MD.app（Mac）或X2MD.exe（Windows）。 - 按向导设置：
- Markdown 保存目录
- 视频保存目录
- 向导完成后，服务会在本地启动（默认
127.0.0.1:9527）。
- 打开
chrome://extensions/ - 开启“开发者模式”
- 点击“加载已解压的扩展程序”
- 选择解压后的
X2MD_Extension目录，或本项目的extension目录
- X / Twitter：打开任意推文页，点击推文操作区的书签按钮。
- LINUX DO：打开话题页，点赞帖子或点击右上角悬浮 MD 按钮。
- 飞书文档：打开 wiki/docx/docs/sheets/mindnotes/minutes 页面，点击右上角悬浮 MD 按钮。
- 飞书聊天记录：打开飞书网页版 messenger 页面，点击右上角悬浮 MD 按钮。
- 微信公众号：打开公众号文章页，点击右上角悬浮 MD 按钮。
- 扩展会将内容发送到本地服务并生成 Markdown。
- 到你设置的目录查看
.md文件。
- 生成内容默认包含 Front Matter。
- 图片会写入原图链接（
name=orig）。 - 视频可配置为下载并写入 Obsidian 嵌入引用。
配置文件位于应用数据目录下的 config.json（Mac: ~/Library/Application Support/X2MD/，Windows: %APPDATA%/X2MD/），也可通过扩展选项页面可视化修改。常用字段：
基础设置：
save_paths: Markdown 输出目录列表filename_format: 文件名模板，支持{summary}{date}{author}max_filename_length: 文件名长度上限video_save_path: 视频保存路径enable_video_download: 是否下载视频video_duration_threshold: 超长视频二次确认阈值（分钟）show_site_save_icon: 是否在支持的站点显示悬浮保存按钮enable_platform_folders: 是否按平台分子文件夹（Twitter/、LINUX DO/、Discourse/、飞书/、飞书聊天/、微信公众号/）download_images: 是否下载远程图片到本地（存入assets/子目录）overwrite_existing: 是否覆盖已存在的同名文件（基于 Front Matter源:URL 去重）
多目标保存：
save_to_obsidian: 保存到本地 Markdown（默认开启）save_to_feishu: 保存到飞书多维表格（需配置飞书 App ID/Secret/Token）save_to_notion: 保存到 Notion 数据库（需配置 Notion Token）export_html: 同时导出 HTML 文件
评论提取：
enable_comments: 是否提取评论max_comments: 最大评论数comments_display: 评论展示方式（details折叠 /inline内联）
推荐模板示例：
{
"filename_format": "{summary}_{date}_{author}",
"max_filename_length": 60,
"enable_video_download": true,
"video_duration_threshold": 5,
"enable_platform_folders": true,
"download_images": true,
"overwrite_existing": false,
"save_to_obsidian": true,
"save_to_feishu": false,
"save_to_notion": false,
"enable_comments": false
}
把高价值推文直接沉淀到素材库，避免后续失链或遗忘。
把 Thread / Note 转成 Markdown 后可快速摘录、改写、重组。
统一命名与元数据，长期形成可检索、可关联的个人知识资产。
- 确认桌面程序正在运行。
- 检查扩展端口与
config.json中port一致。 - 访问
http://127.0.0.1:9527/ping，应返回{"status":"ok"...}。
- 检查
save_paths是否存在写权限。 - 查看日志
x2md.log。
- 检查
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/messenger 提取与解析
│ ├── wechat.js # 微信公众号文章提取
│ ├── site_actions.js # 站点识别与悬浮按钮配置
│ ├── content.js # 内容脚本主入口
│ ├── background.js # Service Worker（API 策略）
│ └── tests/ # Node.js 单元测试
├── BUILD.md # 打包说明
└── docs/images/ # README 配图
- 新增飞书网页版聊天记录提取（messenger 页面），支持内部 API 注入 + DOM 双策略自动降级
- 新增 Discourse 多域名悬浮保存按钮支持（自定义域名在选项页面配置后，悬浮按钮自动生效）
- 修复自定义 Discourse 域名点击悬浮按钮无反应的问题（
handleFloatingSave缺少 discourse case） - 修复自定义 Discourse 域名列表未同步到
site_actions.js导致悬浮按钮不显示的问题 - 新增
sendToBackground诊断日志，便于排查数据发送问题 - 扩展飞书 URL 匹配：新增 sheets、mindnotes 路径支持
- 统一所有组件版本号到 1.6.0
- 修复版本升级后设置向导不弹出、扩展文件不更新的问题
- 新增配置自动合并：升级版本后新增的配置字段自动补全，不覆盖用户已有设置
- 新增扩展版本检测：通过 manifest.json 版本号判断是否需要更新本地 extension 文件夹
- 更新设置向导描述：反映多平台（X/Twitter、LINUX DO、飞书、微信公众号）和多目标保存能力
- 统一所有组件版本号到 1.5.2（server.py / manifest.json / x2md.spec / build.yml）
- 修复 PyInstaller 打包环境下
ZoneInfo("Asia/Shanghai")时区错误导致飞书文章保存 500 的问题 - 新增 ZoneInfo 运行时验证，打包缺失 tzdata 时自动降级为 UTC+8 timedelta
- 补全 config.json 所有缺失的默认字段（飞书多维表格、Notion、HTML 导出等 15+ 字段）
- 新增错误日志 traceback 完整输出，便于排查 Markdown 构建异常
- 新增完整选项面板：9 大分类设置（外观、保存目标、文件路径、媒体嵌入、内容提取、飞书、Notion、HTML 导出、同步）
- 新增多目标保存：Obsidian + 飞书多维表格 + Notion + HTML 导出
- 新增评论提取功能：支持 Discourse 评论、楼层范围筛选
- 新增 Discourse 多域名支持
- 新增配置导入/导出功能
- 新增图片嵌入模式切换（本地/远程链接）
- 合并 @AchengBusiness 的跨平台修复与增强：Windows 兼容性修复、平台分类文件夹、图片本地下载、覆盖/去重、飞书 JSON API、配置导入导出
- 新增 66 个自动化测试（23 个服务端回归 + 43 个 Obsidian 渲染），发布前全部通过
- 修复 LinuxDo lightbox 图片被包成嵌套链接的问题，确保导出 Markdown 为直接图片引用
- README 下载链接、版本徽章与发版口径切回主仓库
- 修复视频占位符
[MEDIA_VIDEO_URL:xxx]泄漏到 Front Matter title 和文件名的 Bug - 同步所有组件版本号到 1.2.3（server.py / manifest.json / x2md.spec）
- 新增 43 个 Obsidian 渲染专项测试，全部 66 个测试 100% 通过
- 修复飞书嵌套列表只输出 children 丢失父级文本的问题
- 修复飞书
document.head为 null 时注入 CSS 崩溃 - 修复 background.js 中
noteResultVideos死代码导致视频合并失败 - 修复 Twitter GraphQL 提取中
note_tweet结构变化的兼容性 - 修复微信公众号代码块
<br>未转换为换行的问题
- 新增覆盖/去重选项：基于 Front Matter
源:URL 自动跳过已保存文件 - 新增飞书 JSON API 提取策略（3 层自动降级：JSON API -> DOM -> 滚动收集）
- 修复 LINUX DO 有序列表和嵌套列表缩进
- 修复多个平台 Front Matter 字段缺失问题
- 新增平台分类文件夹功能（Twitter/、LinuxDo/、Feishu/、WeChat/）
- 新增图片本地下载功能（远程图片 -> assets/ 子目录，相对路径引用）
- 修复跨平台内容提取和 Obsidian 渲染的多个 Bug
- 新增跨设备配置同步功能
- 修复 Windows 打包后
sys.stdout为 None 导致启动崩溃 - 修复 Windows 设置向导字体乱码和 emoji 渲染问题
- 修复 6 个扩展 Bug（GraphQL 权限、监听器泄漏、有序列表等）
- 修复 Windows DLL 崩溃（strip 损坏 DLL + UPX 压缩 Python/VC++ DLL）
- 修复 10 个代码 Bug（路径处理、编码、Front Matter 格式等）
- PyInstaller spec 增加 DLL 保护白名单
- 修复飞书虚拟渲染导致丢失 85% 内容的问题，新增滚动收集机制
- 补充飞书 iframe、table、base_refer、synced_source 等 block 类型
- 提取共享 DOM 工具函数到
dom_utils.js，消除 100+ 行重复代码 - 服务端：配置内存缓存、视频下载线程池限流、日志瘦身
- 打包：排除不必要模块减小 Mac 安装包体积
- 新增微信公众号文章支持（
mp.weixin.qq.com/s/*） - 新增飞书知识库/云文档支持
- 新增 LINUX DO / 飞书 / 微信悬浮保存按钮
- 新增站点快捷保存开关
- 修复 X 长文代码块语言标签未并入 Markdown fenced code block 的问题
感谢所有贡献者，特别是 @AchengBusiness 为本次跨平台增强版带来的大量修复、功能和测试补充。
如果这个工具对你有帮助，欢迎给 izscc/x2md 点个 Star。