Obsidian Image Collector

一个功能强大的 Obsidian 插件，用于从 Markdown 笔记中收集和导出图片，并支持使用 IrfanView 进行批量图片转换。

An powerful Obsidian plugin for collecting and exporting images from Markdown notes, with support for batch image conversion using IrfanView.

功能特性 (Features)

• 可配置导出路径 - 支持相对路径和绝对路径，使用 {{note_name}} 占位符
• IrfanView 集成 - 导出后自动批量转换图片尺寸、DPI 等参数
• 多种图片格式 - 支持 Markdown 标准语法 ![](image.png) 和 Wiki 链接 ![[image.png]]
• 自动目录创建 - 目标目录不存在时自动创建
• 保留/删除原文件 - 转换后可选择保留或删除原始图片

安装 (Installation)

方式一：手动安装

1. 下载最新版本的 main.js 和 manifest.json
2. 在你的 Obsidian vault 中创建目录：.obsidian/plugins/obsidian-image-collector/
3. 将下载的文件复制到该目录
4. 重启 Obsidian 或在设置中启用插件

方式二：从源码构建

# 克隆仓库
git clone https://github.com/TonyHe-Lab/obsidian-image-collector.git
cd obsidian-image-collector

# 安装依赖
npm install

# 构建
npm run build

# 将 main.js 和 manifest.json 复制到 vault 的插件目录

使用方法 (Usage)

基本导出

1. 打开包含图片的 Markdown 笔记
2. 使用以下任一方式触发导出：
   • 按 Ctrl/Cmd + P 打开命令面板，选择 "Export all images from current note"
   • 点击左侧边栏的图片图标

配置导出路径

在 设置 → Image Collector 中配置导出路径模板：

模板	说明	示例结果
Images/{{note_name}}	相对路径，vault 根目录下	Images/MyNote/
C:\Exports\{{note_name}}	Windows 绝对路径	C:\Exports\MyNote\
/home/user/Pictures/{{note_name}}	Linux/Mac 绝对路径	/home/user/Pictures/MyNote/
Exported Images	固定目录，不含笔记名	Exported Images/

配置 IrfanView 转换

1. 确保已安装 IrfanView
2. 在设置中启用 "Enable conversion"
3. 配置 IrfanView 路径（默认：C:\Program Files\IrfanView\i_view64.exe）
4. 设置转换参数，例如：

   /resize=(1770,0) /aspectratio /dpi=(300,300) /resample
   

转换后的文件会添加 _ts 后缀（如 image_ts.png），原始文件会被自动删除。

设置说明 (Settings)

设置项	说明	默认值
Export path template	图片导出路径模板	Exported Images/{{note_name}}
Enable conversion	启用 IrfanView 转换	关闭
IrfanView path	IrfanView 可执行文件路径	C:\Program Files\IrfanView\i_view64.exe
Conversion parameters	转换命令参数	/resize=(1770,0) /aspectratio /dpi=(300,300) /resample

IrfanView 参数参考

常用转换参数：

参数	说明
/resize=(width,height)	调整尺寸，0 表示保持比例
/aspectratio	保持宽高比
/dpi=(x,y)	设置 DPI
/resample	使用重采样算法
/convert="path"	输出路径（插件自动添加）

更多参数请参考 IrfanView 命令行文档。

开发 (Development)

# 安装依赖
npm install

# 开发模式（监听文件变化）
npm run dev

# 生产构建
npm run build

# 版本升级
npm version patch/minor/major

截图 (Screenshots)

设置界面

导出结果

贡献 (Contributing)

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

许可证 (License)

MIT License - 详见 LICENSE 文件

致谢 (Credits)

• Obsidian - 强大的知识管理工具
• IrfanView - 快速轻量的图片查看器和转换器

更新日志 (Changelog)

v1.1.0

• 添加可配置导出路径功能
• 添加 IrfanView 图片转换集成
• 支持绝对路径和相对路径

v1.0.0

• 初始版本发布
• 基础图片导出功能