Skip to content

网页划线怎么同步到 Obsidian:五彩插件分步教程

网页划线本身不值钱,值钱的是它能不能落到你写东西的地方。对 Obsidian 用户来说,最短的路径是五彩官方的社区插件 WuCai Highlights Official:它读你账号里的划线,把每一篇被标注过的文章写成一则 Markdown 笔记,划线和你的批注都在里面。

下面四步走完就能用,后面是笔记长什么样、以及最常见的四种失败。模板变量和版本要求以同步文档为准,这篇讲流程。

开始之前 ​

  • 浏览器里装了五彩,并且至少划过一条线。没有的话先看安装说明。
  • Obsidian 打开了社区插件(设置 → 第三方插件 → 关闭安全模式)。
  • 两边登录的是同一个账号。匿名划线然后等同步,是最常见的空跑。

第一步:在网页上划线 ​

在网页上选中文字划线

打开任意文章选中一句话就行。五彩会记住划线内容、颜色、在页面里的位置,以及你加的批注和标签,并且存在账号里而不是浏览器标签页里——所以关掉标签、换台电脑,记录都还在。

两个细节会直接影响后面同步出来的笔记质量:划线时顺手加标签(标签会变成 Obsidian 笔记的 YAML frontmatter),以及把自己的话写在「批注」里而不是改引文,插件把这两者映射到不同的模板变量。

第二步:在 Obsidian 里装插件 ​

打开 设置 → 第三方插件 → 浏览,搜索「WuCai Highlights Official」(搜 wucai 或「五彩」也能搜到),安装并启用。也可以先在插件页面看一眼再装。

不要给同一个账号同时装两个同步插件。两个写入方指向同一个目录,是笔记互相覆盖的典型原因。

第三步:选区域并登录 ​

Obsidian 里五彩插件的登录界面

五彩按区域分开部署(亚洲、欧洲、北美)。选你注册账号时所在的区域——插件只会连那个区域的服务器,选错了的表现是「登录成功了,但什么都不动」。

用第一步的账号登录。如果登录窗口一闪就关、或者直接报失败,基本可以确定是别的插件拦了跳转:

  • 关掉 Obsidian 内置的浏览器功能;
  • 关掉 Surfing 这类内置浏览插件;
  • 完成授权后再把它们打开。

第四步:把全文同步进仓库 ​

把五彩的划线同步进 Obsidian

插件按「一篇网页一篇笔记」写入。默认目录叫 WuCai,可以在插件选项里改,嵌套目录比如 Inbox/WuCai 也可以。建议和手写笔记分开放:同步会重写它自己管的文件,混在一起就是丢稿的开始。

如果连正文一起要,模板里必须有全文剪藏的块,并且插件版本不低于 23.8.31:

jinja
{% if not isdailynote %}
## 全文剪藏
{% block mdcontent %}
{{mdcontent}}
{% endblock %}
{% endif %}

同步出来的笔记长什么样 ​

默认模板里有文章标题、原文链接、跳回五彩批注页的 {{wucaiurl}}、标签,然后是逐条划线。每条划线带 {{item.note}}(引文)、{{item.annotation}}(你的批注)、{{item.color}} 和 {{item.refurl}}——后者能直接跳回原文的那一段。

这个回跳链接是最该留着的部分。两年后单看笔记往往想不起当时为什么划这句,跳回上下文通常就想起来了。

模板是普通的 Jinja,变量是固定的一组:{{title}}、{{domain}}、{{createat}}、{{tags}}、{{highlights}} 等。变量表在同步文档,可以直接从那里复制;现成的 frontmatter 写法见模板示例。

单向是设计出来的 ​

同步只从五彩流向 Obsidian。在 Obsidian 里改笔记不会回写,删掉笔记也不会删掉划线——下次同步可能又把它写回来。真要某一篇不同步,去五彩后台把它排除掉,而不是删笔记。

正因为单向,定时同步才是安全的:Obsidian 永远是一份副本,不是源头。

常见故障 ​

现象多半是处理
登录窗口一闪就关有插件拦截跳转关掉 Surfing / 内置浏览器后重试
同步跑了,仓库还是空的区域选错重新选账号所在区域
有划线没有正文模板缺 mdcontent 块,或插件版本过低补模板块,升级插件
标签挤成一串YAML 里用了 {{tags}}换成 {{trimtags}} 或 {{alltagsv2}}

这四种之外的情况都在同步文档里;用 Logseq 或思源的,流程同构,见Logseq和思源。

常见问题 ​

同步是双向的吗? 不是。只从五彩到 Obsidian,改笔记不回写,删笔记不影响划线。

同步完之后还要留着浏览器插件吗? 要。插件负责继续采集新的划线,Obsidian 只读账号里已有的内容。

能只同步部分文章吗? 可以,后台逐篇排除即可。

笔记是副本还是链接? 都是。既有内容副本,也有 {{wucaiurl}} 和每条划线的 {{refurl}},离线可读、也能跳回原段落。


相关阅读:五彩和 Web Highlights 怎么选 · 保存网页的五种方法 · 网页划线功能说明 · 安装五彩