Omnivore 集成

Omnivore 是一款开源、隐私友好的稍后阅读应用，支持将阅读高亮和笔记同步到 Obsidian。

为什么选择 Omnivore？

特点	说明
开源免费	完全开源，可自托管
多平台支持	Web、iOS、Android、桌面端
隐私优先	数据加密，本地优先
高亮同步	一键同步所有高亮到 Obsidian
API 支持	完整的 GraphQL API

功能概览

支持的同步内容:
  - 文章高亮
  - 文章笔记
  - 文章标签
  - 文章元数据
  - 阅读状态

支持的同步方式:
  - 官方插件（推荐）
  - 手动 API 调用
  - 第三方工具

安装配置

步骤一：注册 Omnivore 账户

1. 访问 omnivore.app
2. 使用邮箱或第三方账户注册
3. 完成邮箱验证

步骤二：安装浏览器扩展

支持浏览器:
  - Chrome: Chrome Web Store 搜索 Omnivore
  - Firefox: Firefox Add-ons 搜索 Omnivore
  - Safari: App Store 搜索 Omnivore
  - Edge: Edge Add-ons 搜索 Omnivore

步骤三：安装 Obsidian 插件

1. 打开 Obsidian 设置
2. 进入「第三方插件」→「浏览」
3. 搜索 "Omnivore"
4. 安装并启用插件

步骤四：配置 API Key

1. 登录 Omnivore 网页版
2. 进入 Settings → API Keys
3. 点击「Create an API Key」
4. 复制生成的 API Key
5. 在 Obsidian 插件设置中粘贴

插件配置详解

基础设置

# Omnivore 插件设置

API:
  Endpoint: https://api-prod.omnivore.app/api/graphql
  API Key: 你的密钥

同步设置:
  自动同步: 开启
  同步间隔: 60 分钟
  同步目录: Omnivore
  文件命名: "{{title}}"

模板配置

自定义导入的文章格式：

# {{title}}

> [!info] 文章信息
> | 项目 | 内容 |
> |------|------|
> | 作者 | {{author}} |
> | 来源 | {{{siteName}}} |
> | 原文 | {{{originalUrl}}} |
> | 保存时间 | {{dateSaved}} |
> | 标签 | {{#labels}}#{{name}} {{/labels}} |

## 摘要

{{{summary}}}

## 高亮

{{{highlights}}}

## 笔记

{{{notes}}}

---

#omnivore #read

高亮格式

# 高亮显示设置

高亮格式:
  - 高亮文本: `> {{text}}`
  - 带注释: `> {{text}}\n> \n> [!note] 笔记\n> {{note}}`
  - 带 URL: `> {{text}} [↗]({{highlightUrl}})`

颜色映射:
  - 黄色: `=={{text}}==`
  - 绿色: `**{{text}}**`
  - 蓝色: `*{{text}}*`
  - 红色: `~~{{text}}~~`

使用工作流

阅读流程

graph LR
    A[发现文章] --> B[保存到 Omnivore]
    B --> C[阅读并高亮]
    C --> D[添加笔记]
    D --> E[同步到 Obsidian]
    E --> F[整理关联]

快速保存

浏览器扩展：

1. 打开要保存的网页
2. 点击 Omnivore 图标
3. 选择保存选项：
   • 保存文章
   • 保存简版（去除广告）
   • 添加标签
   • 添加到收件箱

邮件转发：

# 发送邮件到你的 Omnivore 邮箱
收件地址: 你的用户名@omnivore.app

支持格式:
  - 纯文本邮件
  - HTML 邮件
  - Newsletter 订阅

快捷键配置

Omnivore 应用快捷键:
  s: 保存当前文章
  h: 添加高亮
  n: 添加笔记
  a: 归档
  l: 添加标签

Obsidian 插件快捷键:
  Ctrl/Cmd + Shift + O: 同步 Omnivore

高级配置

过滤同步

只同步特定标签的文章：

# 插件设置中的过滤规则

过滤条件:
  - 标签: "#important"
  - 状态: "completed"
  - 日期: "最近 30 天"

高级查询:
  # 使用 GraphQL 查询
  query: "label:important is:read"

自定义模板变量

# 可用变量

基础变量:
  - {{title}}: 文章标题
  - {{{originalUrl}}}: 原文链接
  - {{author}}: 作者
  - {{{siteName}}}: 来源网站
  - {{dateSaved}}: 保存日期
  - {{datePublished}}: 发布日期

内容变量:
  - {{{summary}}}: AI 生成的摘要
  - {{{content}}}: 文章完整内容
  - {{{highlights}}}: 所有高亮
  - {{{notes}}}: 所有笔记

标签变量:
  - {{#labels}}#{{name}} {{/labels}}: 标签列表
  - {{#labels}}[[{{name}}]]{{/labels}}: 链接格式

与其他插件联动

Templater 联动：

<%*
// 自动提取高亮中的代码块
const highlights = tp.frontmatter.highlights || '';
const codeBlocks = highlights.match(/```[\s\S]*?```/g);
if (codeBlocks) {
  tR += `\n## 代码片段\n`;
  codeBlocks.forEach(block => tR += block + '\n\n');
}
%>

Dataview 查询：

TABLE
  author as 作者,
  dateSaved as 保存日期,
  length(highlights) as 高亮数
FROM "Omnivore"
WHERE dateSaved >= date(today) - dur(7 days)
SORT dateSaved DESC

数据管理

存储结构

vault/
└── Omnivore/
    ├── 文章标题-1.md
    ├── 文章标题-2.md
    └── ...

清理策略

自动清理:
  - 已归档文章: 不同步
  - 删除的文章: 保留本地副本
  - 重复保存: 合并高亮

手动管理:
  - 定期整理 Omnivore 文件夹
  - 删除不需要的文章
  - 合并相似主题

与 Readwise 对比

| Omnivore | Readwise | |------|----------|----------| | 价格 | 免费 | $8.99/月 | | 开源 | ✅ | ❌ | | 自托管 | ✅ | ❌ | | 高亮同步 | ✅ | ✅ | | Kindle 支持 | ❌ | ✅ | | AI 摘要 | ✅ | ✅ | | Newsletter | ✅ | ❌ |

常见问题

Q: 同步失败怎么办？

A:

1. 检查 API Key 是否正确
2. 确认网络连接正常
3. 查看 Omnivore 服务状态
4. 尝试重新生成 API Key
5. 检查插件日志

Q: 如何处理重复文章？

A:

1. Omnivore 会自动检测重复
2. 在设置中启用「合并高亮」
3. 手动删除本地重复文件

Q: 支持哪些内容源？

A:

• 网页文章（HTML）
• PDF 文档
• 邮件
• Newsletter
• RSS 订阅（通过第三方工具）

Q: 高亮不显示？

A:

1. 确认文章已在 Omnivore 中打开
2. 检查模板中的高亮变量
3. 尝试手动同步

相关资源

• Omnivore 官网
• Omnivore GitHub
• Readwise 集成 - 另一个高亮同步方案
• 文献管理 - 学术文献方案