Obsidian图片一键上传兰空图床插件

项目概述

在日常使用 Obsidian 进行笔记管理时,插入和管理图片往往是一项重复且繁琐的任务,特别是需要图片同步和外链的用户。obsidian-lskypro-uploader 以解决此痛点为出发点,为用户提供了便捷的图片上传方式。通过这个插件,用户只需轻松一键操作,便可将图片从本地笔记直接上传至高效且功能丰富的兰空图床(LskyPro),自动生成外链并嵌入至笔记内容中,不仅优化了图片管理流程,还保障了图片资源的统一性和稳定性。插件采用 TypeScript 编写,紧贴 Obsidian 的使用习惯与生态系统,让图片上传更加智能、高效。与传统的手动图片处理方式相比,这一方案大幅提升了信息整理的效率,使用户专注于内容创作本身,是 Obsidian 用户实现 “写作无忧、插图随心” 的理想选择。

项目统计

:bar_chart: 项目概况

:star: 2 Stars | :fork_and_knife: 0 Forks | :eyes: 2 Watchers | :bug: 0 Issues

:page_facing_up: 开源协议: MIT License | :date: 创建于: 2025-03-21 | :counterclockwise_arrows_button: 更新于: 2025-05-06

:laptop: 技术栈

该项目主要使用 TypeScript 开发,占代码库的 95.7%。此外还包含 JavaScript (4.3%)

核心功能

Obsidian日记党、笔记达人看过来!如果你还在为管理和分享Obsidian中的图片资源而犯愁,那么 obsidian-lskypro-uploader 就是你的好帮手。它让图片上传这件“小事”,变得异常顺滑高效——你再也不用手动操作图片上传、复制图床链接了!下面来看看它带来的实用功能吧:

  • 一键上传图片:只需几步简单操作,就能把你在Obsidian文档中插入或粘贴的图片,自动上传到兰空图床(LskyPro)中存储,省时省力。
  • 自动生成外链:图片上传后,插件会直接返回外链地址,并自动插入到你的Markdown文档中,无需手动更改书写格式,让写作流畅无阻。
  • 快捷操作体验:支持拖拽、粘贴等多种图片添加方式,无论是本地图片还是截图,都能即刻上传,打破平台壁垒。
  • 集成兰空图床:将Obsidian与强大的LskyPro图床后台无缝链接,统一管理图片资源,减少笔记“臃肿”,让本地库清爽如新。
  • 灵活配置:用户可自行设定LskyPro的相关API与参数,满足不同图床部署的需求。

更多功能特性正在不断完善中。无论你是重度图片用户、还是追求笔记整洁的效率达人,这个插件都能大大提升你的Obsidian使用体验。快来试试,让你的图片管理告别麻烦、迈向智能吧!

技术架构

本项目基于 Obsidian 插件开发体系,采用主流的 TypeScript 作为核心编程语言,充分利用其类型安全和良好的开发体验,实现了在 Obsidian 笔记软件内与兰空图床(LskyPro)服务的无缝集成。插件通过调用 LskyPro 提供的 HTTP API,实现图片的自动上传、链接获取及插入到笔记内容中,有效提升了用户在 Obsidian 内处理图片资源的效率。

在架构设计上,插件遵循 Obsidian 插件系统标准,模块划分清晰,核心逻辑围绕图片选取、API 交互与用户回馈三大环节展开。图片上传流程大致如下:用户在笔记中粘贴或插入图片后,插件自动拦截操作、读取图片数据,通过 HTTP POST 请求将图片上传至 LskyPro 图床服务器,获响应后返回图片外链,最后将该链接以 Markdown 格式插入到笔记中。该流程高度自动化,显著降低了用户的操作门槛。

核心技术选型方面,TypeScript 不仅增强了代码的可维护性和可读性,同时便于社区后期扩展和贡献。借助现代浏览器 API 和 Obsidian 插件开发文档,项目兼顾了易用性与稳定性,成为提升 Markdown 图片管理体验的高效工具。

使用指南

安装

  1. 在 GitHub Releases 页面下载最新版的 obsidian-lskypro-uploader.zip
  2. 解压并将整个文件夹放入 Obsidian 的插件目录:
    你的库目录/.obsidian/plugins/obsidian-lskypro-uploader/
  3. 进入 Obsidian,点击“设置”->“第三方插件”,启用 LskyPro Uploader 插件。

插件配置

  1. 打开 Obsidian 设置,进入“LskyPro Uploader”配置页。
  2. 填写你的 LskyPro 图床信息,如下所示:
配置项 说明 示例
LskyPro Host 图床API地址 https://image.example.com
Token 访问Token xxxxxxxxxxxxxxxxxxxx
Save Path 上传路径 obsidian/notes-imgs

设置保存后,插件会自动生效。

图片上传使用方法

  • 方式一:粘贴图片
    在编辑器中直接粘贴截图、图片,插件会自动识别并将图片上传至 LskyPro,返回图片链接插入笔记。

  • 方式二:本地图片引用
    在笔记中插入本地图片(如 ![[图片.png]] 或拖入图片),右键图片,选择“上传至 LskyPro”即可自动替换为图床链接。

代码示例:

![示例图片](https://image.example.com/obsidian/notes-imgs/example.png)

上传完成后,图片即通过外链方式引用,无需占用本地空间。如此你可以无忧地管理与使用远程图片。

总结评价

obsidian-lskypro-uploader 是一款针对 Obsidian 用户的实用插件,专注于将图片无缝上传到兰空图床(LskyPro)。该项目以 TypeScript 开发,开源协议为 MIT,当前获得了 2 颗 Star,社区活跃度和用户基础尚处在初期阶段。插件的主要亮点是填补了 Obsidian 与 LskyPro 之间的集成空白,为有图片管理需求的用户提供了便捷选择。尽管目前功能相对简单,但其专一性和开源特性为后续扩展和定制化提供了良好基础。建议对兰空图床有需求的 Obsidian 用户尝试该插件,并关注其后续发展。未来,若能完善文档、增加更多配置和优化上传体验,有望吸引更广泛用户并提升项目影响力。