baoyu-danger-x-to-markdown

此工具通过将个别推文、完整线程 (threads) 和 X 文章转换为带有 YAML 前言的结构化 Markdown 文件，简化了从 X (前身为 Twitter) 归档内容的过程。专为研究人员、内容策展人和知识管理人员设计，它能自动提取元数据（包括作者详细信息、URL 和图像封面资源），确保您的本地笔记能准确反映社交媒体内容的原始语境。

• 自动识别推文或文章 URL 并将其解析为干净、易读的 Markdown。

• 支持完整的线程重组，将个别回复合并为带有 YAML 标头的连贯文档。

• 提供强大的媒体处理功能，包括可选择性地将图像和视频下载到本地目录，并在输出文件中自动重写为相对路径。

• 与本地文件系统整合，通过用户名和推文 ID 维护组织良好的归档。

• 为其逆向工程的 X API 实施了强制性的同意流程，确保用户了解潜在的 API 稳定性或账号相关风险。

• 通过 EXTEND.md 提供灵活的配置系统，允许用户为特定项目或全局设置定义自定义输出路径和预设的媒体下载行为。

• 输入：提供 x.com 或 twitter.com 的状态或文章链接。工具会通过内部引擎解析这些链接，并在首次执行时请求用户同意。

• 输出：产生包含 YAML 前言的 .md 文件，记录 URL、作者和推文数量。媒体资源可选择性地保存到本地 /imgs 和 /videos 文件夹。

• 使用：通过 CLI 执行，并可搭配 --download-media 等选项处理本地资源，或使用 --json 获取结构化数据。请始终确保在指定路径存在同意文件，以避免操作中断。

• 注意：此工具依赖逆向工程的 API 端点，该端点可能会随时变更。它旨在用于个人知识管理，并非官方的 X 集成工具。