之前一直使用 Typora,最近切换到了 Obsidian。然而,我发现现有的 Obsidian 图片上传插件体验都不太理想,于是和 Antigravity 老师一起搓了这个插件。它的主要功能是拦截 Obsidian 的图片粘贴事件,将图片自动上传到配置的图床,并替换为远程链接。

[开源项目] Obsidian 图片上传插件,基于 upgit
2 mins

obsidian-upgith1

项目地址: https://github.com/kiusnax/obsidian-upgit

一个简单的 Obsidian 图片上传插件,基于 upgit

简介h2

之前一直使用 Typora,最近切换到了 Obsidian。然而,我发现现有的 Obsidian 图片上传插件体验都不太理想,于是和 Antigravity 老师一起搓了这个插件。

它的主要功能是拦截 Obsidian 的图片粘贴事件,将图片自动上传到配置的图床,并替换为远程链接。

演示h2

2026-01-23_17-10-45.webp

功能特点h2

  • 无缝体验:直接粘贴图片,插件会自动处理上传。
  • 即时反馈:粘贴后立即显示本地预览,后台静默上传,上传成功后自动替换为远程链接。
  • 灵活配置:基于强大的 upgit CLI 工具,支持多种图床配置。

前置要求h2

本插件依赖于 upgit 命令行工具。在使用前,请确保你已经下载并配置好了 upgit

确保 upgit 在你的终端中可以通过命令正常上传图片。

配置指南h2

  1. 安装插件:将本仓库代码编译后的 main.js, manifest.json 文件放入 Obsidian 仓库的 .obsidian/plugins/obsidian-upgit/ 目录下。
  2. 启用插件:在 Obsidian 设置 -> 第三方插件中启用 obsidian-upgit
  3. 插件设置
    • 打开插件设置页面。
    • Upgit Executable Path: 填写 upgit 可执行文件的绝对路径 (例如: C:\Tools\upgit.exe/usr/local/bin/upgit)。
    • Local Assets Folder: (可选) 设置临时图片的存储目录,默认为 assets

使用方法h2

配置完成后,只需在 Obsidian 编辑器中粘贴图片(Ctrl+V / Cmd+V),插件即可自动工作。

开发h2

Terminal window
npm install
npm run dev