Obsidian

Obsidian 图片本地化教程:图片保存在哪、为什么图片会失效打不开、网络图片怎么批量下载到本地(下载到本地 / 保留原始链接 / 不加载图片)

笔记同步助手 · ·Obsidian 教程
Obsidian图片本地化图片处理模式图片失效图片显示不出来图片保存在哪附件文件夹网络图片下载到本地图床Web Clipper教程

Obsidian 图片本地化:图片保存在哪、为什么会失效、下载到本地 / 保留原始链接 / 不加载图片怎么选

经常有用户问这样一个问题:

转发了一篇文章,结果把文章的图片单独给我开了一个文件夹记下来。我不太需要额外的文件夹记录图片,我需要整一篇文章在同一个文件中,包括图片——这个能关掉吗?

能关,但关掉有代价。要理解这个代价,先要弄清楚 Obsidian 里的图片到底存在哪

一、Obsidian 图片保存在哪?笔记里显示的图,就是旁边那个文件夹里的文件

下面是一个真实的 Obsidian 库。左边红框是插件下载到本地的图片文件(images 文件夹里的 6 个 JPG),右边红框是文章里显示出来的图:

左边 images 文件夹里的图片文件,就是右边文章里显示的那些图

右边的图不是”装在”笔记里的,它只是在展示左边的文件。 Obsidian 是本地笔记,一篇笔记就是一个 .md 纯文本文件,文本文件里放不进图片;笔记里能看到图,是因为正文里有一行 ![[images/xxxx.jpg]],告诉 Obsidian 去左边那个文件夹里把图片取出来显示。这就是 Obsidian 的图片嵌入语法:![[…]] 是内部链接,指向库里的文件;![](https://…) 是外部链接,指向网络上的图片。

笔记同步助手下载的图片默认放在库里的 笔记同步助手/images 文件夹,位置由插件设置里的「图片存储文件夹」决定——它和 Obsidian 自带的「附件默认存放路径」是两回事,互不影响。

不信可以做个实验:在左边删掉第一张图片文件,右边文章里立刻就少一张图。

所以在 Obsidian 里,「整篇文章连图片一起装进一个文件」这件事本身是不成立的——图片要么以文件的形式存在你库里的某个文件夹,要么只能留在别人的服务器上、笔记里只写一个网址。这就是三种图片处理模式的分水岭。

二、三种图片处理模式:下载到本地 / 保留原始链接 / 不加载图片

设置位置:Obsidian → 设置 → 第三方插件 → 笔记同步助手 → 往下翻到「图片处理」→「图片处理模式」。

插件设置里的「图片处理模式」,三个选项:下载到本地 / 保留原始链接 / 不加载图片

1. 下载到本地(默认,推荐)

同步时,插件把文章里的每张图片下载成你库里的文件(默认存到 笔记同步助手/images),笔记正文里写成 ![[笔记同步助手/images/xxxx.jpg]]——就是上面截图里的样子。

  • 图片永远是你的:源站删图、加防盗链、链接过期,都不影响你已经下好的图;断网也能看。
  • 代价:占本地磁盘;库里会多一个图片文件夹。
  • 想让图片不散落在公共 images 文件夹里、而是跟着各自的笔记走:把「图片存储文件夹」改成带 {{{title}}} 的路径,见《把图片和笔记放在一起》——每篇笔记和它的图片同处一个目录,删笔记时把整个目录一起删掉即可。
  • 想省空间:打开「PNG 转 JPEG」,并把「JPEG 质量」调低一点(默认 85)。

2. 保留原始链接(外链图片,不下载)

不下载图片,笔记里保留图片的网址 ![](https://…),打开笔记时才联网加载。库里不会有图片文件夹,一篇文章就是一个 .md 文件。

用 Obsidian 官方的 Web Clipper 剪藏出来的网页笔记也是这种形态。下面这张截图里,红框就是图片的网址,库里没有对应的图片文件:

用 Obsidian Web Clipper 剪藏的笔记,图片是一行 https 网址,库里没有图片文件

但代价很直接:文章里的网图一旦没了,Obsidian 里的图也就没了。 具体来说:

  • 图片本体在别人的服务器上。源站把图删了、加了防盗链、链接自带的有效期到了——笔记里的图就打不开了,只剩一个裂开的图标。
  • 经笔记同步助手云空间中转的图片,也最长只保留 30 天
  • 断网看不了图。

可以自己做个实验:用 Web Clipper 剪一篇带图的文章,两三周后再打开,多半图就没了。

适合的场景:临时看看、不打算长期保留的资料;或者你已经开启了云端图床接力——图片已经在你自己的图床上、链接由你掌控,这时应当选「保留原始链接」以保住图床链接。

3. 不加载图片

插件把图片语法注释掉(<!-- ![](…) -->),正文里不显示任何图片,笔记最干净、体积最小。适合只要文字、或者图片特别多影响阅读的场景。图片的网址仍然留在文件里(编辑模式能看到),只是不显示。

三种模式对比

下载到本地保留原始链接不加载图片
笔记里写的是![[images/xxx.jpg]](本地文件)![](https://…)(网址)<!-- ![](…) -->(注释掉)
图片文件在哪你库里的图片文件夹别人的服务器 / 云空间中转不存
会不会失效不会会(源站删图、防盗链、链接过期;云空间中转最长 30 天)本来就不显示
断网能看吗不能无图
占本地空间不占不占
库里有没有图片文件夹没有没有

三、能不能”不要图片文件夹”?图片太占空间怎么办?

能——把模式改成「保留原始链接」就没有图片文件夹了。但按上面说的,几周后文章里的图会陆续打不开,所以我们默认是「下载到本地」,也建议保持默认

如果你的顾虑其实是下面这几种,各有更好的解法:

  • 嫌图片散落在公共文件夹里、不好整理把图片和笔记放在一起,每篇笔记的图片就放在它自己的目录里,整理、移动、归档都跟着笔记一起走。
  • 担心占电脑空间 → 一篇图文文章的图片通常几百 KB 到几 MB,几百篇也就几百 MB,一般电脑放得下;实在在意就开「PNG 转 JPEG」,或者用图床接力把图片上传到自己的图床,库里不留图片文件、链接又是自己的。
  • 就是不想在本地管图片文件 → 换 OneNote 或 Notion 作为目的地,图片存在它们的云端、不在你电脑上;笔记同步助手对这两款同样支持,高级权益也是共享的。

四、重新本地化:把笔记里的网络图片批量下载回本地(图片失效前补救)

本功能需要插件 3.1.6 及以上版本(插件会自动更新到最新版;查看版本:Obsidian → 设置 → 第三方插件 → 笔记同步助手)。

三种情况会用到:

  1. 之前用「保留原始链接」同步的笔记,现在改主意了,想把图片存到本地;
  2. 开着「下载到本地」,但同步当时网络不好、图床暂时不可用,笔记里留下了远程链接(形如 ![](https://…)),断网或链接过期后图片就看不了;
  3. 用 Obsidian Web Clipper 或其它工具剪藏的网页笔记,图片是外链,想一并存到本地——右键菜单对库里任何一篇 Markdown 笔记都有效,不限于笔记同步助手同步来的笔记。

都不需要重新同步整篇笔记。先确认「图片处理模式」是「下载到本地」,然后在电脑端 Obsidian 里右键笔记:

  1. 在左侧文件列表中右键要修复的笔记,菜单里有两个选项:

    • 将本笔记图片重新本地化:只处理当前这一篇
    • 将本文件夹图片重新本地化:把这篇笔记所在文件夹(含子文件夹)的所有笔记批量处理

    直接右键文件夹也可以:文件夹的右键菜单里同样有「将本文件夹图片重新本地化」。

右键菜单:两个重新本地化选项

  1. 点「将本笔记图片重新本地化」,完成后弹出「本地化完成」提示,笔记里的远程链接变成本地附件嵌入(![[笔记同步助手/images/xxx.png]]),图片从此保存在你自己的库里:

单篇笔记重新本地化完成

  1. 如果一个文件夹里很多篇笔记都有远程图片,点「将本文件夹图片重新本地化」一次批量处理,完成提示会显示处理的笔记数:

整个文件夹批量重新本地化,提示处理了 2 个笔记

打开同文件夹的其它笔记可以看到图片也一并变成了本地附件:

同文件夹第二篇笔记的图片也已本地化

几点说明:

  • 要趁图片链接还没失效时做——链接已经打不开的图片是下载不回来的(这也是建议一开始就选「下载到本地」的原因)。
  • 部分图片下载失败时,提示会如实显示「本地化未成功:N 项仍是远程链接,稍后会自动重试」——下次同步会自动再试,也可以稍后再右键重试一次。
  • 插件设置里「图片处理模式」没开「下载到本地」时,这两个菜单项显示为「将本笔记附件重新本地化 / 将本文件夹附件重新本地化」,只处理附件不处理图片。想重新下载图片,先把「图片处理模式」设为「下载到本地」。
  • 该操作只重新下载图片/附件、改写图片链接,不会改动笔记文字内容,也不会重复从云空间拉取笔记。

五、Obsidian 图片常见问题

Obsidian 图片显示不出来 / 图片裂开了,怎么办?

先看笔记里那行图片语法是哪种:

  • ![](https://…) 网络链接:源站删图、加了防盗链、链接过期,都会让图裂开。趁链接还能打开时,右键笔记 →「将本笔记图片重新本地化」把图下载到本地;已经打不开的链接下载不回来。
  • ![[images/xxx.jpg]] 本地引用:图片文件本来在库里,但 images 文件夹里的文件在 Obsidian 之外被移动、改名或删除了,引用找不到文件。把图片放回原路径;或者在云端暂存期内按云空间教程把这篇笔记重新拉取一次。

Obsidian 图片保存在哪个文件夹?能改位置吗?

笔记同步助手下载的图片默认在库里的 笔记同步助手/images,由插件设置「图片存储文件夹」决定,与 Obsidian 自带的「附件默认存放路径」无关。可以改成任意路径,支持 {{{title}}}{{{date}}}{{{yearSaved}}}/{{{monthSaved}}} 等变量,详见路径设置教程

怎么把 Obsidian 笔记里的网络图片批量下载到本地?

把「图片处理模式」设为「下载到本地」,然后在电脑端右键文件夹 →「将本文件夹图片重新本地化」,该文件夹(含子文件夹)里所有笔记的网络图片会一次性下载到本地并改写成 ![[…]] 引用。步骤见上面第四节。

图片太占空间、库变得很大怎么办?

  • 打开「PNG 转 JPEG」并适当调低「JPEG 质量」,图片体积通常能小一半以上(代价是丢失 PNG 的透明背景)。
  • 图床接力把图片上传到自己的图床或对象存储,笔记里换成你自己图床的链接,库里不留图片文件。
  • 只是临时看看的资料,可以先切到「保留原始链接」同步,需要长期保存的再右键重新本地化。

手机端同步也会下载图片吗?

会。「下载到本地」在手机端同样生效,图片会下载进手机上的库里,离线也能看。

想把图片放到自己的图床(PicGo / 对象存储)怎么做?

图床接力教程:云端接力(在网页设置里填对象存储密钥,图片在整理阶段就直接上传到你的桶)或本地接力(借助 PicGo 等图床插件,同步完成后批量上传)。开了云端接力后,图片处理模式应选「保留原始链接」以保住图床链接。

相关阅读