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语法生成
- 可配置的图片描述模板
| |