Web Clipper 使用指南

Obsidian Web Clipper 是 Obsidian 官方推出的浏览器扩展，让你在浏览网页时快速将内容保存到 Obsidian 仓库中，是构建知识库的重要入口工具。

简介

什么是 Web Clipper

Web Clipper 是一个浏览器扩展，支持 Chrome、Firefox、Safari 和 Edge 等主流浏览器。它可以将网页内容以 Markdown 格式保存到你的 Obsidian 仓库中。

为什么需要 Web Clipper

• 快速捕获：一键保存网页内容，无需手动复制粘贴
• 结构化保存：自动提取标题、正文、作者、日期等元数据
• Markdown 格式：保存的内容直接兼容 Obsidian 笔记格式
• 模板自定义：支持自定义保存模板，适配不同类型的内容

安装

Chrome / Edge

1. 访问 Chrome Web Store
2. 点击"添加到 Chrome"/"添加到 Edge"
3. 安装完成后，浏览器工具栏出现 Obsidian 图标

Firefox

1. 访问 Firefox Add-ons
2. 点击"添加到 Firefox"
3. 安装完成后，浏览器工具栏出现 Obsidian 图标

Safari

1. 从 Mac App Store 下载 Obsidian Web Clipper
2. 在系统设置中启用扩展

初始配置

连接 Obsidian 仓库

1. 确保 Obsidian 正在运行
2. 点击浏览器工具栏的 Obsidian 图标
3. 选择要保存到的仓库
4. 选择目标文件夹
5. 确认连接成功

本地仓库优先

Web Clipper 优先连接本地运行的 Obsidian 实例。如果你的仓库使用了同步方案，剪藏的内容会自动同步到其他设备。

基本设置

设置项	说明	推荐值
默认文件夹	剪藏内容保存位置	Inbox 或 Clippings
标签	自动添加的标签	#web-clip
文件命名	笔记文件名格式	{{title}}
模板	使用的剪藏模板	根据内容类型选择

使用方式

快速剪藏

1. 在浏览器中打开要保存的网页
2. 点击 Obsidian 图标或使用快捷键
3. 选择剪藏模式
4. 点击保存

快捷键：

• Chrome/Edge：Alt + Shift + O
• Firefox：Alt + Shift + O
• 可在扩展设置中自定义快捷键

剪藏模式

全文剪藏

保存网页的完整正文内容，适合需要保留全部信息的场景。

选区剪藏

只保存选中的文本内容：

1. 在网页上选中要保存的文本
2. 点击 Obsidian 图标
3. 自动切换为选区模式
4. 保存选中内容

书签模式

只保存网页的标题、链接和简要描述，适合快速收藏：

---
title: 文章标题
source: https://example.com/article
author: 作者名
date: {{date}}
tags: [bookmark, web-clip]
---

## 摘要

简短描述文章内容...

Markdown 剪藏

将网页内容转换为 Markdown 格式保存，保留标题层级、列表、代码块等格式。

模板系统

内置模板

Web Clipper 提供多种内置模板：

模板	用途
默认模板	通用网页剪藏
文章模板	博客文章、新闻
学术论文	论文、研究报告
食谱模板	烹饪食谱
商品模板	产品信息收藏

自定义模板

创建自定义模板以适配个人工作流：

---
title: "{{title}}"
source: "{{url}}"
author: "{{author}}"
date: {{date}}
tags: [web-clip, {{domain}}]
status: seedling
---

## 概述

{{description}}

## 正文

{{content}}

## 我的笔记

<!-- 在此添加个人思考 -->

## 相关笔记

- [[]]

模板变量

变量	说明
{{title}}	网页标题
{{url}}	网页 URL
{{author}}	作者
{{date}}	当前日期
{{content}}	正文内容
{{description}}	网页描述
{{domain}}	域名
{{selection}}	选中文本
{{tags}}	网页标签

进阶用法

配合 QuickAdd 使用

将 Web Clipper 与 QuickAdd 结合，实现更强大的捕获工作流：

1. 在 QuickAdd 中创建捕获选择
2. 设置 Web Clipper 的默认保存文件夹为 QuickAdd 的临时目录
3. 通过 QuickAdd 命令快速处理剪藏内容

配合 Dataview 查询

使用 Dataview 查询管理剪藏内容：

TABLE source as "来源", date as "日期", tags as "标签"
FROM "Inbox"
WHERE contains(tags, "web-clip")
SORT date DESC
LIMIT 20

自动分类

通过模板和文件夹规则实现自动分类：

• 学术论文 → References/Papers/
• 技术文章 → Learning/Tech/
• 新闻资讯 → Inbox/News/
• 食谱 → Life/Recipes/

常见问题

问：Web Clipper 无法连接 Obsidian？

答：请检查：

1. Obsidian 是否正在运行
2. 本地 HTTP API 是否启用（设置 → 核心/社区插件）
3. 防火墙是否阻止了连接
4. 浏览器扩展是否有访问本地服务的权限

问：剪藏的内容格式不正确？

答：

• 尝试切换不同的剪藏模式
• 检查自定义模板的格式
• 部分网站使用动态加载，可能需要先滚动页面再剪藏

问：如何批量剪藏？

答：

• 使用书签模式快速收集多个链接
• 之后在 Obsidian 中逐个深入阅读
• 或使用 Templater 批量处理剪藏笔记

相关资源

• 网页剪藏 — 高级剪藏技巧
• QuickAdd 插件 — 快速捕获工具
• Dataview 实战 — 数据查询管理
• 笔记组织方法 — 文件组织策略
• 导入笔记 — 其他导入方式