Obsidian 学习笔记

Appearance

Readwise Reader 集成 ​

Readwise Reader 是一款集稍后阅读、RSS 订阅、高亮标注于一体的阅读工具，配合 Readwise 官方 Obsidian 插件，可以将所有阅读高亮和笔记自动同步到 Obsidian。

关于 Omnivore

Omnivore 曾是一款优秀的开源稍后阅读应用，但已于 2024 年底停止服务。如果你之前使用 Omnivore，建议迁移到 Readwise Reader 或其他替代方案。Omnivore 的开源代码仍可自托管使用，但不再有官方支持。

为什么选择 Readwise Reader？ ​

特点说明
全能阅读器网页文章、RSS、Newsletter、PDF、EPUB 一站式管理
高亮同步一键同步所有高亮和笔记到 Obsidian
AI 功能内置 Ghostreader AI 助手，支持摘要、问答、翻译
多平台Web、iOS、Android、浏览器扩展
标签系统支持文件夹和标签双重组织

安装配置 ​

步骤一：注册 Readwise 账户 ​

  1. 访问 readwise.io
  2. 注册账户（提供 30 天免费试用）
  3. 订阅 Readwise Reader（$8.99/月，含高亮同步功能）

步骤二：安装浏览器扩展 ​

在浏览器中安装 Readwise 扩展，用于保存网页文章：

步骤三：安装 Obsidian 插件 ​

  1. 打开 Obsidian 设置 → 第三方插件 → 浏览
  2. 搜索 "Readwise Official"
  3. 安装并启用插件

注意

请安装 "Readwise Official" 插件，而非第三方的 "Readwise Community" 插件。官方插件由 Readwise 团队维护，功能更完善。

步骤四：配置 API Token ​

  1. 访问 readwise.io/access_token
  2. 复制你的 Access Token
  3. 在 Obsidian 插件设置中粘贴 Token
  4. 点击「Sync Now」测试连接

插件配置详解 ​

基础设置 ​

设置项推荐值说明
Sync Frequency每 60 分钟自动同步间隔
FolderReadwise同步目标文件夹
Filename{{title}}文件命名模板
Template默认自定义导入模板

模板配置 ​

自定义导入的文章格式，在插件设置中编辑 Header Template 和 Highlight Template：

Header Template 示例：

markdown
# {{title}}

::: info 文章信息
| 项目 | 内容 |
| ---- | ---- |
| 作者 | {{author}} |
| 来源 | {{source}} |
| 原文 | {{url}} |
| 保存时间 | {{created_at}} |
| 标签 | {{tags}} |
:::

Highlight Template 示例：

markdown
> {{text}} [↗]({{location}})

{% if note %}
::: info 笔记
{{note}}
:::
{% endif %}

同步文件夹结构 ​

建议按来源分文件夹：

text
vault/
└── Readwise/
    ├── Articles/       # 网页文章
    ├── Books/          # 电子书高亮
    ├── Podcasts/       # 播客笔记
    ├── Supplementals/  # PDF 高亮
    └── Tweets/         # 推特书签

在插件设置中启用「Organize by source type」自动分类。

使用工作流 ​

阅读流程 ​

mermaid
graph LR
    A[发现内容] --> B[保存到 Reader]
    B --> C[阅读并高亮]
    C --> D[添加笔记]
    D --> E[自动同步到 Obsidian]
    E --> F[整理与关联]

快速保存 ​

浏览器扩展保存：

  1. 打开要保存的网页
  2. 点击 Readwise 图标
  3. 文章自动保存到 Reader

邮件转发：

  • 将 Newsletter 转发到你的 Readwise 邮箱
  • 支持 HTML 邮件和纯文本

RSS 订阅：

  1. 在 Reader 中添加 RSS 源
  2. 新文章自动出现在收件箱
  3. 阅读高亮后同步到 Obsidian

移动端使用 ​

  • iOS 快捷指令：分享菜单直接保存到 Reader
  • Android：通过分享菜单保存
  • Readwise Reader App：直接在 App 中阅读和高亮

与 Dataview 联动 ​

同步到 Obsidian 的文章包含丰富的 frontmatter 元数据，可以用 Dataview 查询：

最近阅读的文章 ​

dataview
TABLE
  author AS "作者",
  category AS "来源",
  dateformat(file.mtime, "yyyy-MM-dd") AS "同步时间"
FROM "Readwise"
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC
LIMIT 10

按标签筛选 ​

dataview
TABLE
  author AS "作者",
  length(filter(file.outlinks, (x) => contains(meta(x).path, "Readwise"))) AS "高亮数"
FROM "Readwise"
WHERE contains(tags, "技术")
SORT file.mtime DESC

统计阅读量 ​

dataview
TABLE length(rows) AS "文章数"
FROM "Readwise"
GROUP BY category
SORT length(rows) DESC

高级配置 ​

过滤同步内容 ​

在插件设置中配置过滤规则：

  • 仅同步已读文章：Document Status = Read
  • 仅同步特定标签：Tags contains #important
  • 排除短文章：Word Count > 500

自定义 Frontmatter ​

在模板中添加自定义 frontmatter 字段：

yaml
---
title: "{{title}}"
author: "{{author}}"
source: "{{source}}"
url: "{{url}}"
tags: [readwise, {{tags}}]
status: "{{status}}"
read_date: "{{created_at}}"
---

与 Templater 联动 ​

使用 Templater 自动处理同步后的文章：

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

从 Omnivore 迁移 ​

如果你之前使用 Omnivore，可以按以下步骤迁移：

步骤一：导出 Omnivore 数据 ​

  1. 登录 Omnivore 网页版（如仍可访问）
  2. 进入 Settings → Data Export
  3. 导出所有高亮数据

步骤二：导入到 Readwise ​

  1. 访问 readwise.io/import
  2. 选择 Omnivore 作为来源
  3. 上传导出文件
  4. 等待导入完成

步骤三：清理 Obsidian 中的 Omnivore 文件 ​

  1. 删除 Omnivore/ 文件夹
  2. 卸载 Omnivore 插件
  3. 安装 Readwise Official 插件
  4. 首次同步到 Readwise/ 文件夹

与其他方案对比 ​

特性Readwise ReaderInstapaperPocket
高亮同步到 Obsidian✅ 官方插件❌❌
RSS 订阅✅❌❌
PDF/EPUB 阅读✅❌❌
AI 功能✅ Ghostreader❌❌
Newsletter✅❌❌
价格$8.99/月免费/$2.99月免费
开源❌❌❌

常见问题 ​

Q: 同步失败怎么办？ ​

A:

  1. 检查 API Token 是否正确
  2. 确认网络连接正常
  3. 在插件设置中点击「Reset Sync」重新同步
  4. 查看 Obsidian 开发者控制台的错误日志

Q: 如何处理重复文章？ ​

A:

Readwise 通过 URL 自动去重。如果出现重复：

  1. 在插件设置中启用「Dedupe on sync」
  2. 手动删除 Obsidian 中的重复文件
  3. 在 Readwise 中合并重复条目

Q: 图片能同步吗？ ​

A:

Readwise 插件默认不同步文章中的图片。如需图片：

  1. 使用「Download Images」插件将外链图片本地化
  2. 或在 Readwise 中手动复制图片到 Obsidian

Q: 费用太贵，有免费替代吗？ ​

A:

免费替代方案：

  • Omnivore 自托管：需要技术基础，代码开源在 GitHub
  • Cubox：国内稍后阅读应用，有 Obsidian 同步插件
  • Hypothesis：网页标注工具，有社区 Obsidian 插件
  • 手动导出：从任何阅读器导出高亮，手动粘贴到 Obsidian

相关资源 ​