核心用法
obsidian-save-article 是一款面向 Obsidian 用户的网页剪藏工具，通过解析用户提供的 URL 和可选笔记，自动抓取网页全文并保存为结构化的 Markdown 文件。其核心工作流包括：
1. 智能抓取：优先使用 Jina.ai Reader 服务提取网页正文，支持 X(Twitter)、微信公众号等特殊站点
2. 元数据归档：自动生成 YAML Frontmatter，包含标题、原始链接、创建日期及页面评论
3. 结构化存储：正文以折叠 Callout 形式保存，用户笔记转为带唯一 Block Reference 的引用块
4. 增量更新：通过 URL 识别重复内容，支持替换而非重复创建
显著优点
- 格式规范化：自动清理零宽字符、控制字符等破坏 Markdown 渲染的隐形符号
- 双向链接友好：Block Reference ID 机制使笔记可被 Obsidian 内部链接引用
- 内容完整性：50000 字符上限配合截断提示，平衡存储与完整性
- 本地优先：数据完全存储于用户本地 vault，无云端依赖
潜在局限
- 依赖第三方服务：Jina.ai Reader 的可用性直接影响抓取成功率
- 动态内容限制：对需要登录或重度 JS 渲染的页面提取效果有限
- 文件命名约束：标题自动转义可能丢失部分语义信息
- 无自动同步：需配合 Obsidian 官方同步或第三方方案实现多端访问
适合人群
- Obsidian 重度用户构建第二大脑
- 研究人员进行文献管理和网页资料归档
- 需要离线访问网页内容的隐私敏感用户
常规风险
- URL 解析依赖用户输入准确性， malformed 链接可能导致抓取失败
- 高频率调用 Jina.ai 可能触发速率限制
- 本地文件系统权限不足时保存操作将中断