SiYuan 是一款隐私优先的开源个人知识管理软件。其网页剪藏功能支持完整页面、选区及静默模式保存，保留原格式并建立双向链接。通过浏览器扩展安装、设置默认存储路径及格式选项，可实现高效的知识收集。内容管理支持智能去重、块级编辑及 API 批量处理。常见问题包括剪藏失败排查与格式修复，结合自动化工作流与 OCR 插件可进一步提升效率。
你是否还在为网页内容保存不完整、格式错乱而烦恼？作为一款隐私优先的个人知识管理软件，SiYuan（思源笔记）提供的网页剪藏功能彻底解决了这一痛点。本文将带你掌握从安装配置到高级剪辑的全流程，让网页知识收集效率提升。
传统网页保存方式存在三大痛点：格式丢失、链接失效、管理混乱。SiYuan 作为开源知识管理工具，通过深度整合的剪藏功能实现了三大突破：
技术实现：SiYuan 通过自研的块级文档模型（Block Model）和 kernel/api/clipboard.go 处理剪贴板数据，结合 app/src/protyle/util/paste.ts 实现富文本解析，确保内容无损转换。
SiYuan 提供浏览器扩展实现一键剪藏，支持 Chrome/Edge 等基于 Chromium 的浏览器：
chrome://extensions/ 进入扩展管理通过 SiYuan 的设置界面配置剪藏内容的默认存储位置：
/剪藏/{{domain}}/{{date}} 格式）配置文件路径：剪藏规则保存在工作空间的
conf/appearance.json中，可通过 API 接口进行批量配置。
适用于需要完整保存文章、教程等内容的场景：
技术原理：扩展通过
chrome.tabs.captureVisibleTab()获取页面截图，同时使用document.execCommand('copy')复制完整 DOM 结构，通过自定义协议siyuan://clipboard传输到客户端。
针对只需部分内容的场景，实现精准知识截取：
代码示例：选区剪藏的核心处理逻辑
// 简化自 app/src/protyle/util/paste.ts
async function handleSelectionClipboard() {
const selection = window.getSelection();
if (!selection.rangeCount) return;
const range = selection.getRangeAt(0);
const fragment = range.cloneContents();
// 创建临时容器处理选中内容
const tempDiv = document.createElement('div');
tempDiv.appendChild(fragment);
// 处理图片和相对链接
await fixRelativeResources(tempDiv);
// 通过 IPC 发送到主进程
window.api.send('clipboard:html', tempDiv.innerHTML);
}
适合需要批量保存多个页面的场景，不打断浏览流程：
提示：可在 SiYuan 的设置 > 通知中配置剪藏完成提醒方式，支持系统通知和桌面通知两种模式。
SiYuan 提供智能去重功能，避免重复剪藏相同内容：
利用 SiYuan 的块编辑能力优化剪藏内容：
Ctrl+Shift+D 将长文本拆分为逻辑段落Ctrl+B 添加高亮标记[[ 插入内部链接，建立知识网络快捷键参考：完整的编辑快捷键列表可在帮助文档目录下的 guide 目录中查看。
当剪藏功能异常时，可按以下步骤诊断：
logs/ 目录下的 clipboard.log 定位错误若剪藏内容出现格式问题，可尝试：
Ctrl+Shift+V）对于大量历史剪藏内容，可通过 SiYuan 的 API 编写处理脚本：
# 使用 SiYuan API 批量更新剪藏标签
import requests
API_TOKEN = "your_token_here"
BASE_URL = "http://127.0.0.1:6806/api"
headers = {
"Authorization": f"Token {API_TOKEN}",
"Content-Type": "application/json"
}
# 获取所有剪藏文档
response = requests.post(f"{BASE_URL}/filetree/lsNotebooks", headers=headers)
notebooks = response.json()["data"]["notebooks"]
# 批量添加标签
for notebook in notebooks:
if "剪藏" in notebook["name"]:
requests.post(f"{BASE_URL}/attr/setBlockAttrs", headers=headers, json={
"id": notebook["id"],
"attrs": {"custom-tags": "web,clipboard"}
})
通过本文学习，你已掌握 SiYuan 网页剪藏的核心技能。建议进一步探索：
资源推荐：官方提供的剪藏示例库位于 app/guide/20211226090932-5lcq56f，包含多种场景的最佳实践。
立即开始使用 SiYuan 剪藏，让网页知识真正成为你的个人知识库一部分。如有问题，可访问中文讨论区获取社区支持。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online