Markdown Image Paste
一个VSCode插件，用于在Markdown文件中自动上传粘贴的图片到七牛云，并生成相应的Markdown图片语法。
功能特性
- 🖼️ 自动检测图片粘贴：在Markdown文件中粘贴图片时自动检测
- ☁️ 七牛云上传：自动将图片上传到七牛云存储
- 📝 Markdown语法生成：自动生成标准的Markdown图片语法
- ⚙️ 灵活配置：支持自定义图片前缀、描述模板等
- 🎯 仅在Markdown文件中工作：只在.md文件中激活，不影响其他文件类型
安装
- 在VSCode扩展市场搜索 "Markdown Image Paste"
- 点击安装
- 重启VSCode
配置
在使用前，你需要配置七牛云相关设置：
- 打开VSCode设置 (Ctrl+,)
- 搜索 "markdownImagePaste"
- 配置以下必需项：
可选配置
- Image Prefix: 上传图片的文件名前缀 (默认: "images/")
- Image Alt Template: 图片描述模板，支持占位符:
{timestamp}: 时间戳{date}: 日期{time}: 时间
- Add Newline After: 在插入的图片后添加换行符
- Add Newline Before: 在插入的图片前添加换行符
使用方法
- 复制一张图片到剪贴板（截图、复制图片文件等）
- 在Markdown文件中按
Ctrl+Shift+V (Mac: Cmd+Shift+V)
- 插件会自动：
- 检测剪贴板中的图片
- 上传到七牛云
- 在光标位置插入Markdown图片语法
命令
Markdown Image Paste: Paste Image - 手动粘贴图片Markdown Image Paste: Configure Qiniu Cloud Settings - 打开配置向导
快捷键
Ctrl+Shift+V (Mac: Cmd+Shift+V) - 在Markdown文件中粘贴图片
七牛云配置指南
- 注册七牛云账号：https://www.qiniu.com/
- 进入控制台 > 密钥管理
- 创建或复制你的Access Key和Secret Key
- 创建存储空间并记录名称
- 在七牛云控制台配置你的域名
支持的图片格式
- PNG
- JPEG/JPG
- GIF
- WebP
- BMP
故障排除
图片无法上传
- 检查七牛云配置是否正确
- 确保网络连接正常
- 检查存储空间权限设置
- 验证七牛云域名是否正确配置
无法检测到图片
- 确保剪贴板中确实包含图片数据
- 尝试重新复制图片（截图或复制图片文件）
- 检查图片格式是否支持
- 在macOS上，确保VSCode有剪贴板访问权限
插件不工作
- 确保当前文件是Markdown文件 (.md)
- 检查插件是否已启用
- 重启VSCode
- 查看开发者控制台的错误信息
常见错误
"clipboardEx.readImage is not a function"
这个错误已经在最新版本中修复。请确保使用最新版本的插件。
需要在VSCode设置中配置七牛云相关参数：
- 打开设置 (Ctrl+,)
- 搜索 "markdownImagePaste"
- 填写所有必需的配置项
权限问题
在某些系统上，可能需要给VSCode剪贴板访问权限：
- macOS: 系统偏好设置 > 安全性与隐私 > 隐私 > 辅助功能
- Windows: 通常不需要额外权限
- Linux: 可能需要安装 xclip 或 xsel
调试模式
如果遇到问题，可以：
- 打开VSCode开发者工具 (Help > Toggle Developer Tools)
- 查看控制台输出
- 运行测试脚本：
node test-clipboard.js
开发
# 克隆项目
git clone <repository-url>
# 安装依赖
npm install
# 编译
npm run compile
# 监听模式
npm run watch
许可证
MIT
贡献
欢迎提交Issue和Pull Request！
更新日志
1.0.0
- 初始版本
- 支持七牛云图片上传
- 自动Markdown语法生成
- 可配置的图片描述模板
| |
