在 Obsidian 里，同步笔记并补充本地素材

步骤 1

选择安装渠道并启用插件

云端同步支持 Windows、macOS、Linux、iOS 和 Android 的 Obsidian，可从社区市场安装 Clip2MD。需要桌面本地剪藏时，可从官网“同步设置”下载网站整合版，一个 clipmd 插件目录内已包含本地扩展，不需要再安装第二个桌面插件。

手动安装时，解压并将 clipmd 文件夹放入当前 Vault 的 .obsidian/plugins/，确认 manifest.json、main.js 等程序文件就在该目录内，再在 Obsidian“设置 → 社区插件”中启用 Clip2MD。

网站整合版与社区主插件使用同一 ID。更换渠道前先停用旧版，只覆盖程序文件并保留现有配置；不要把两个版本的程序文件混在一起。网站版在插件内检查更新，更新完成后重启 Obsidian。

步骤 2

连接账号，先完成一次云端同步

打开 Clip2MD 设置，通过“微信扫码绑定”连接自己的 Clip2MD 账号，也可在插件界面手动填写 Key。设置 Vault 内的目标文件夹，点击“测试连接”，再点击“立即同步”。

在 Vault 中确认 Markdown 和图片已写入。任务提交成功、云端处理完成、同步完成是不同状态；每台设备和每个 Vault 都需要独立确认。自动同步需要 Obsidian 正在运行。

步骤 3

开启本地扩展，准备工具并登录原站

在 Clip2MD 设置中打开“本地剪藏扩展”，开启“启用本地剪藏扩展”。网站版首次开启会检查并准备 Whisper、FFmpeg、yt-dlp 和固定转写资源，可复用可用的本机工具；工具保存在 Vault 外。

网站版自动工具安装支持 macOS Apple Silicon／Intel 和 Windows x64，所需下载来自 Clip2MD 自有 CDN static.clip2md.cn，并校验文件完整性。macOS 编译环境缺失、网络或工具检查失败时，按页面提示重试或复制 Agent 修复说明。其他系统不提供自动安装；移动端不运行本地扩展。

分别开启需要的平台，在原站登录窗口完成授权，再勾选采集能力。Cookie 保留在本机；不要把 Cookie、API Key 或绑定码复制给 Agent。公开通用网页可先配置 HTTPS 域名，需要授权的页面会另外提示。

步骤 4

选择素材，检查本地处理结果

按平台分别选择“补充来源属性”“正文图文”“视频／音频”“评论”“字幕与本地转写”“封面／原图”。平台卡片只展示相应能力，不代表该平台每条链接都包含全部素材。

新同步笔记按当前平台配置进入本地队列；已有剪藏可在“保存与处理 → 已有笔记补充”点击“选择笔记”。字幕优先使用来源字幕或内嵌字幕，缺少字幕时再尝试已通过自检的 Whisper 本地转写。

查看本地队列中的授权、写入、失败与完成状态，按需暂停、恢复或重试。检查补充笔记、真实媒体和文本内容，不能把封面、简介或空评论提示当作完整采集结果。用户修改过的补充内容发生冲突时，按提示保留并处理。

普通本地补充保存在 Vault；网页同步设置中的“云端失败自动走本地解析”会把取得的原文回传云端生成智能笔记，仍按任务规则使用额度，不等于离线免费重试。

步骤 5

设置目录、正文与属性模板

目录与文件名在“命名与目录”中配置，正文与属性在“笔记内容 → 自定义模板”中配置。目录填写 Vault 相对路径；自定义标题必须单行。正文与 YAML 属性分开填写，正文可用 {{content}} 放入所选同步内容，不能以 YAML 属性区开头。不同输入支持的变量不同，请使用旁边的变量说明并检查预览。

评论与本地素材可设置独立保存位置；本地“资料存放目录”留空时跟随主笔记。修改模板或目录主要影响之后的新建或重建内容，不会自动移动和重写所有历史笔记。

检查“已保存 / 未保存”提示，先同步一条样本，确认文件名、正文、属性和素材链接，再应用到更多内容；渲染后的长文件名可能被截短。

步骤 6

从平台收藏导入

在“保存与处理 → 从平台收藏导入”或已登录的平台卡片中打开导入。可读取 B站当前账号自建收藏夹、小红书收藏或抖音收藏，选择可识别的单条作品；喜欢列表和已失效作品不等同于可导入收藏。

导入前检查已有任务和可用额度，只创建余额允许的部分，仍按云端剪藏规则计费。读取和导入进度会保留，限流、网络中断或队列已满时可继续剩余项；原站未确认分页结束时不能把当前列表视为全部收藏。

新建任务继续经过云端处理、Obsidian 同步和本地素材队列。收藏导入不会自动替你开启平台全部能力；按需先配置功能，导入后分别检查云端结果和本地文件。