obsidian-clipper-template-creator

Obsidian Web Clipper 模板创建指南

技能概述

这是一个帮助您创建 Obsidian Web Clipper 可导入 JSON 模板的技能，通过分析网页结构、验证 CSS 选择器并生成符合规范的模板配置。

适用场景

1. 为特定网站创建专用剪藏模板

当您需要从 YouTube、食谱网站、博客等特定来源剪藏内容时，此技能可以帮您分析网页的 Schema.org 数据、Meta 标签和 DOM 结构，生成能够精确提取标题、作者、发布日期等元数据的模板。

2. 学习和使用 Obsidian Clipper 变量

如果您想了解 Obsidian Web Clipper 支持哪些变量（Preset、Schema、Selector），以及如何使用过滤器格式化剪藏内容，此技能提供完整的变量参考和实际示例。

3. 验证和调试 CSS 选择器

在创建模板时，选择器错误是最常见的问题。此技能强调"先获取再验证"的工作流程，通过实际网页内容验证每个 CSS 选择器的有效性，避免猜测和无效配置。

核心功能

1. 网页分析与选择器验证

在生成模板前，技能会获取实际网页内容并分析 HTML 结构，包括 Schema.org JSON、Meta 标签和 CSS 选择器。每个选择器都必须通过真实内容验证，绝不凭空猜测。这确保了生成的模板能够可靠地提取目标内容。

2. Base Schema 映射与结构化属性

技能支持读取用户定义的 Base Schema（如 Recipes.base），将预定义的属性映射到 Clipper 模板中，实现一致的内容结构和属性命名。这对于构建知识库和保持剪藏内容格式统一非常有用。

3. 标准 JSON 模板生成

最终输出符合 Obsidian Web Clipper 规范的 JSON 配置文件，包含 schemaVersion、name、properties 等必需字段。生成的代码块可以直接复制导入 Obsidian，即插即用。

常见问题

Obsidian Web Clipper 模板文件应该存放在哪里？

模板文件通常存放在 Obsidian 仓库的 Templates/ 目录下。如果您使用 Base Schema 定义属性结构，可以在 Templates/Bases/ 目录下创建 .base 文件，技能会自动读取并应用这些属性定义。

如何确保 CSS 选择器稳定有效？

本技能遵循"先获取后验证"原则：您需要提供目标网页的 URL，技能会获取实际 HTML 内容并分析 DOM 结构。优先使用稳定的定位方式，如 data 属性、语义化标签和唯一 ID，避免使用容易变化的类名链。如果选择器无法验证，技能会明确提示并提供替代方案。

为什么我的模板提取不到内容？

最常见的原因是 CSS 选择器与实际 DOM 不匹配。请确保：1) 提供了正确的示例 URL 用于分析；2) 选择器在验证步骤中已通过测试；3) 目标网站没有动态加载内容（这类内容需要等待 JavaScript 渲染）。如果问题持续，尝试提供网页截图以帮助诊断。

Obsidian Clipper 支持哪些变量？

支持三类主要变量：Preset 变量（如 {{title}}、{{url}}、{{date}}）、Schema 变量（从 Schema.org JSON-LD 提取，如 {{schema:name}}）、Selector 变量（通过 CSS 选择器提取，如 {{selector:div.author}}）。完整变量列表请参考 Obsidian 官方文档或技能内的 references/variables.md。

可以创建剪藏视频信息的模板吗？

可以。针对 YouTube 等视频网站，技能会分析页面结构提取视频标题、作者、时长、发布日期等信息。关键步骤是提供视频页面 URL，让技能验证选择器能否正确提取目标元素。您也可以基于现有的 YouTube 模板示例进行修改。

模板 JSON 格式有错误怎么排查？

常见的 JSON 格式错误包括：缺少逗号、引号不匹配、使用了单引号而非双引号、最后一项后有逗号等。本技能生成的 JSON 会自动遵循规范。如果您手动修改模板，建议使用 JSON 验证工具检查语法，或让技能重新生成完整的配置。