核心用法
feed-to-md 是一款基于 feed2md CLI 的 RSS/Atom 订阅源转换工具,可将任何标准格式的订阅链接一键转为易读的 Markdown 文档。核心操作极为简洁:直接调用 feed2md "<feed_url>" 即可在终端输出转换结果;若需保存,追加 --output <file> 参数即可写入文件。
功能亮点
- 双模板预设:内置
short(精简列表)与full(完整详情)两种模板,满足不同场景需求 - 自定义模板:支持 Eta 模板引擎,用户可编写
.eta模板文件实现完全个性化的输出格式 - 内容控制:通过
--limit限制条目数量,--no-summary关闭摘要,--summary-max-length截断长文本 - 零配置运行:优先检测全局安装的 CLI,未安装时自动降级至
npx临时执行,无需预装依赖 - 脚本化集成:提供
./scripts/feed-to-markdown.sh包装脚本,便于 CI/CD 或定时任务集成
显著优点
1. 格式标准化:自动解析 RSS 2.0、Atom 等主流格式,统一输出为 Markdown,消除源站 HTML 渲染差异
2. 离线友好:转换后的 Markdown 可配合 Obsidian、Notion、Git 等工具实现纯本地内容管理
3. 可编程性强:CLI 设计遵循 Unix 哲学,便于管道串联(如 feed2md url | grep "关键词")
潜在局限
- 网络依赖:源站可访问性直接决定成功率,私有 feed 或反爬站点可能受限
- 模板学习成本:自定义 Eta 模板需了解模板语法,对非技术用户存在门槛
- Node 生态依赖:基于 Node.js/npm,Windows 环境需额外配置或使用 WSL
适合人群
- 知识库构建者:定期归档博客、Newsletter 至本地 Markdown 库
- 内容策展人:批量提取订阅源文章生成精选列表或周报
- 开发者/自动化工程师:集成至 GitHub Actions 等工作流实现自动同步
常规风险
- 来源可信度:需自行验证 feed URL 的合法性,避免订阅恶意或钓鱼站点
- 内容版权:批量导出可能涉及版权内容,需遵守源站使用条款
- 依赖包安全:
@myx0m0p/feed2md-cli为第三方 npm 包,建议锁定版本并审计依赖
---
> 使用建议:对于高频使用场景,推荐全局安装 npm install -g @myx0m0p/feed2md-cli 以获得最佳性能;临时使用或 CI 环境优先使用 npx -y 避免环境污染。