Obsidian Web Clipper

使用 Obsidian Web Clipper 非常简单，你只需要在浏览器和 Obsidian 之间“牵线搭桥”。整个过程就是：安装扩展 → 连接 Obsidian → 开始剪藏。

### ⚙️ 1. 安装与连接

1. **安装扩展**：在 Chrome、Firefox 或 Safari 等浏览器的官方扩展商店中搜索 **“Obsidian Web Clipper”**，然后点击安装。
2. **连接 Obsidian**：
* 打开 Obsidian 桌面软件，然后点击浏览器工具栏里的紫色插件图标。
* 如果系统提示连接，请授予权限。之后需要**将弹出窗口中的`Vault Name`（知识库名称）与你当前打开的知识库名称完全对齐**。注意，这里填写的是知识库的名字，而不是它在电脑里的文件夹路径。
3. **测试一下**：配置完成后，可以尝试剪藏一个简单的网页，比如一篇新闻，如果 Obsidian 中出现了对应的 Markdown 文件，就说明一切正常了。

### 📝 2. 核心功能使用

* **启动剪藏**：可以通过**浏览器工具栏图标**、【网页右键菜单】或**快捷键**三种方式随时唤醒插件。
* **设置剪藏内容优先级**：插件会按以下优先级挑选最终保存的内容：
1. **自定义模板** (最高)
2. **手动选择的文字**
3. **高亮标记的内容**
4. **智能提取的正文内容** (最低)
* 你可以通过鼠标拖选网页文字，并用高亮工具标记重点，来影响剪藏结果。
* **设置存储位置**：在剪藏窗口的底部操作区，可以指定剪藏内容要存储的具体知识库和文件夹路径。
* **编辑与确认**：保存前，你可以在预览窗口编辑标题、修改元数据或删减内容，调整到满意为止再点击“Add to Obsidian”。

### 🎨 3. 个性化模板：开启高效剪藏

模板是 Web Clipper 的灵魂，能让你为不同类型的网站定制专属的剪藏格式。

* **创建与管理**：在插件设置中进入“Templates”界面，可以新建、编辑、复制、删除模板，甚至导入/导出 `.json` 格式的模板文件与他人分享。
* **这是模板的结构和常用变量参考：**
“`markdown
—
title: {{title}}
original_source: {{url}}
clipped_date: {{date|formatDate:”YYYY-MM-DD”}}
author: {{author|default(“Unknown”)}}
tags: [web-clipper, {{domain}}]
—
# {{title}}
**原文链接**: [{{url}}]({{url}})
**剪藏时间**: {{date|formatDate:”YYYY年MM月DD日 HH:mm”}}

## 内容摘要
{{abstract}}

## 详细内容
{{content}}
“`
* **核心变量与过滤器**：
* `{{title}}`: 网页标题
* `{{url}}`: 网页链接
* `{{date}}`: 当前剪藏日期
* `{{content}}`: 提取的正文内容
* `{{published}}`: 文章原始发布日期
* `{{author}}`: 页面作者信息
* `{{domain}}`: 网页域名
* 过滤器（如 `formatDate`）可以对变量进行格式化，更多高级用法可以查阅官方文档。
* **自动应用模板**：可以为模板设置 URL 匹配规则。访问特定网站（如 `https://www.bbc.com/news`）时，插件会自动套用对应的模板，实现“因地制宜”的智能剪藏。
* **模板分享与获取**：官方维护的 [clipper-templates 仓库](https://github.com/kepano/clipper-templates) 提供了大量实用模板，可以直接导入使用。

### ✨ 4. “解释器 (Interpreter)”：用AI增强剪藏

“解释器”是扩展中一个很有特色的功能。启用后，你可以用**自然语言**来处理网页内容。

* **快速总结**：例如，输入提示“总结这篇文章的三个要点”，插件就能在保存内容的同时执行这些操作。
* **数据结构化**：你可以将非结构化的数据整理成统一的格式，为高级数据处理打下基础。

### 🔧 5. 高效技巧与常见问题

* **常用快捷键**：
* 打开剪藏面板：`Ctrl/Cmd + Shift + O`
* 快速保存当前页面：`Alt/Opt + Shift + O`
* 切换高亮标记模式：`Alt/Opt + Shift + H`
* 如果快捷键冲突，可以在扩展设置中自定义修改。
* **常见问题排查**：
* **连接失败**：先检查 Obsidian 软件是否开启，然后确认填写的 Vault Name 是否和 Obsidian 中显示的名字完全。
* **保存内容不完整**：可能是页面结构复杂，可以尝试手动选择正文区域后再剪藏。
* **快捷键不起作用**：先检查是否与浏览器或其他扩展快捷键冲突；此外，Safari 浏览器默认可能不支持修改快捷键组合。
* **版本兼容性**：保持 Obsidian 和插件均为最新版本，有时能解决大部分功能异常的问题。

### 🤝 6. 社区与支持

如果内置功能无法满足需求，你还可以探索社区驱动的工具来实现更复杂的操作：

* **Obclip**：一款本地命令行工具，支持通过 URL 批量剪藏网页，适合需自动化处理大量网页的技术用户。
* **Obsidian Easy Clipper**：对 YouTube 字幕、X/Reddit 帖子做了特别优化。
* 当遇到问题时，你也可以访问 [Obsidian 官方论坛](https://forum.obsidian.md/) 寻找帮助，或者直接在 [GitHub 仓库](https://github.com/obsidianmd/obsidian-clipper) 提交 Issue。

总的来说，从基础的“三步连线”到创建定制化模板，Web Clipper 的核心思路就是为 Obsidian 打通一张精准高效的“捕网”。希望这份指南能帮助你顺利上手，如果对某个环节有疑问，可以随时再问我～