图片与图床¶
笔记常常需要配图,而 VNote 让插图变得毫不费力:粘贴一张图片,它就会被保存进笔记本并自动生成链接。当你想分享纯 Markdown 文件却不想附带图片文件时,图床会把你的图片改为存放在网络上。
插入图片¶
添加图片最快的方式是把它(截图,或从别处复制的图片)直接粘贴进编辑器。VNote 会:
- 把图片文件保存进笔记本的附件——默认位于笔记本根目录下的
vx_assets文件夹中(放在按笔记划分的子文件夹里)。 - 替你插入 Markdown 链接。
你也可以从文件插入图片,或将图片拖放进编辑器。由于图片存放在笔记本内,当你复制或同步笔记本时,它们会随之一起迁移。
本地图片与图床¶
VNote 支持两种存储策略,你可以在编辑器中按笔记切换:
- 本地图片——文件存放在笔记本内。自包含且适合离线。
- 图床——图片上传到在线服务,笔记链接到在线 URL。此时 Markdown 文件不再引用任何本地文件,因此你可以分享纯文本,读者在任何地方都能看到图片。
网络不佳时的一个实用流程:写作时先本地插入图片,最后再把笔记中的所有图片一并上传到图床。
什么是图床¶
图床是一个在线保存你图片的服务。与本地图片不同,使用图床的笔记本身不携带任何图片文件——你可以只把 Markdown 文本交给别人,他们依然能看到每一张在线加载的图片。
配置图床¶
首先在设置对话框中配置图床。VNote 支持三种图床类型——GitHub 仓库、Gitee 仓库和自定义命令(Custom Command)——然后在编辑器中选择使用本地图片或图床。
GitHub / Gitee¶
Gitee 的流程与之类似;这里以 GitHub 为例。
- 在 GitHub 中进入 Settings → Developer settings,生成一个新的 Personal access token。
- 选择 repo 权限范围,生成令牌并复制它。
- 创建一个公开仓库来存放图片。生成默认的
README,让仓库有一次初始提交。 - 在 VNote 中新建图床,填入 Personal Access Token、User Name 和 Repository Name。
配置完成后,上传一张图片(或笔记中的所有图片)会把文件推送到该仓库,并将链接改写为它们的在线 URL。
自定义命令¶
自定义命令类型通过运行你定义的外部命令来上传图片,因此你可以对接任何提供命令行工具的上传器或图片服务。VNote 会把图片传给你的命令,并使用它返回的 URL。
编辑器如何管理图片文件¶
编辑器会让笔记的本地图片文件与其内容保持一致,因此你很少需要亲自去动附件文件夹:
- 清理未使用的图片。 当你关闭一篇笔记的最后一个视图时,VNote 会删除该笔记不再引用的本地图片文件——包括打开时就存在、或本次会话中插入但随后被删除的图片。这可以避免附件文件夹被无用文件塞满。对图床上未使用图片的清理是可选的,由设置中的清理图床上未使用的图片(仅基于当前文件)控制。
- 粘贴时复制被链接的图片。 当你粘贴的文本中含有指向现有本地图片的相对链接(例如从另一篇笔记搬来的内容)时,VNote 会询问是连同链接的图片一起粘贴还是作为纯文本粘贴。选择连同链接的图片一起粘贴会把每个被引用的图片复制到当前笔记的附件中并改写链接,使其在新位置依然有效;对同一来源的重复引用只会复制一次,并会有一个汇总告知复制或跳过了多少个。
小贴士¶
- 妥善保管令牌——把个人访问令牌当作密码对待。
- 追求可携带、离线的笔记就用本地图片;用于公开分享则用图床。