206 lines
5.3 KiB
Markdown
206 lines
5.3 KiB
Markdown
# Bulk Copy with Images - 图片优化增强版
|
||
|
||
一键复制 Obsidian 笔记全文，自动转换为富文本 HTML，图片内嵌为 base64。完美支持飞书云文档、微信公众号、知乎等多种编辑器平台。
|
||
|
||
## ✨ 核心功能
|
||
|
||
### 1. 完整的排版保留
|
||
- ✅ 标题（H1-H6）
|
||
- ✅ 粗体、斜体、删除线、高亮
|
||
- ✅ 代码块和行内代码
|
||
- ✅ 列表（有序、无序）
|
||
- ✅ 引用块
|
||
- ✅ 表格
|
||
- ✅ 链接
|
||
- ✅ 分割线
|
||
|
||
### 2. 智能图片处理
|
||
- ✅ **自动压缩**：大图自动缩放到合适尺寸
|
||
- ✅ **质量优化**：在清晰度和文件大小间取得平衡
|
||
- ✅ **显示控制**：限制图片最大显示宽度，避免过长
|
||
- ✅ **格式转换**：统一转为 JPEG 格式（压缩率更高）
|
||
- ✅ **特殊处理**：
|
||
- SVG：保持矢量格式
|
||
- GIF：保留动画效果
|
||
- PNG/JPG：智能压缩
|
||
|
||
### 3. 多平台兼容
|
||
- 飞书云文档 ✅
|
||
- 微信公众号 ✅
|
||
- 知乎 ✅
|
||
- 语雀 ✅
|
||
- Notion ✅
|
||
- 其他富文本编辑器 ✅
|
||
|
||
## 🎯 图片优化说明
|
||
|
||
### 当前配置
|
||
|
||
```javascript
|
||
const IMAGE_CONFIG = {
|
||
MAX_WIDTH: 800, // 压缩最大宽度（像素）
|
||
QUALITY: 0.8, // 压缩质量（0-1）
|
||
DISPLAY_MAX_WIDTH: 600 // 显示最大宽度（像素）
|
||
};
|
||
```
|
||
|
||
### 参数说明
|
||
|
||
#### 1. `MAX_WIDTH` - 压缩最大宽度
|
||
- **作用**：超过此宽度的图片会被等比缩放
|
||
- **默认值**：800px
|
||
- **建议值**：
|
||
- 微信公众号：800px（推荐）
|
||
- 飞书文档：1000px
|
||
- 知乎：800px
|
||
- 如果图片需要更清晰：1200px
|
||
- 如果想要更小的文件：600px
|
||
|
||
#### 2. `QUALITY` - 压缩质量
|
||
- **作用**：控制 JPEG 压缩质量
|
||
- **默认值**：0.8（80%）
|
||
- **建议值**：
|
||
- 高质量（文件较大）：0.85-0.9
|
||
- 平衡模式（推荐）：0.75-0.85
|
||
- 高压缩（文件小，质量降低）：0.6-0.75
|
||
|
||
#### 3. `DISPLAY_MAX_WIDTH` - 显示最大宽度
|
||
- **作用**：图片在编辑器中的最大显示宽度
|
||
- **默认值**：600px
|
||
- **说明**：
|
||
- 这个设置**不影响图片实际尺寸**
|
||
- 只控制图片在编辑器中的显示宽度
|
||
- 避免图片在编辑器中显得过长
|
||
|
||
### 如何自定义配置？
|
||
|
||
打开 `main.js`，修改文件开头的配置：
|
||
|
||
```javascript
|
||
/* ========== 图片优化配置 ========== */
|
||
const IMAGE_CONFIG = {
|
||
MAX_WIDTH: 800, // 改成你想要的压缩宽度
|
||
QUALITY: 0.8, // 改成你想要的质量（0-1）
|
||
DISPLAY_MAX_WIDTH: 600 // 改成你想要的显示宽度
|
||
};
|
||
```
|
||
|
||
### 压缩效果对比
|
||
|
||
| 原始图片 | 压缩后 | 节省空间 |
|
||
|---------|--------|---------|
|
||
| 5MB, 3000x2000 | ~150KB | 97% |
|
||
| 2MB, 1920x1080 | ~80KB | 96% |
|
||
| 500KB, 800x600 | ~60KB | 88% |
|
||
|
||
## 📖 使用方法
|
||
|
||
### 方法 1：快捷键
|
||
1. 打开任意 Markdown 笔记
|
||
2. 按 `Ctrl+Shift+C`（Windows/Linux）或 `Cmd+Shift+C`（Mac）
|
||
3. 粘贴到目标编辑器
|
||
|
||
### 方法 2：命令面板
|
||
1. 按 `Ctrl+P`（Windows/Linux）或 `Cmd+P`（Mac）
|
||
2. 输入"复制全文"
|
||
3. 选择"复制全文并内嵌本地图片"
|
||
4. 粘贴到目标编辑器
|
||
|
||
## 💡 使用技巧
|
||
|
||
### 1. 不同平台的建议配置
|
||
|
||
**微信公众号**（推荐当前配置）
|
||
```javascript
|
||
MAX_WIDTH: 800
|
||
QUALITY: 0.8
|
||
DISPLAY_MAX_WIDTH: 600
|
||
```
|
||
|
||
**飞书云文档**（可以更高清）
|
||
```javascript
|
||
MAX_WIDTH: 1000
|
||
QUALITY: 0.85
|
||
DISPLAY_MAX_WIDTH: 700
|
||
```
|
||
|
||
**知乎**（兼顾质量和加载速度）
|
||
```javascript
|
||
MAX_WIDTH: 800
|
||
QUALITY: 0.8
|
||
DISPLAY_MAX_WIDTH: 600
|
||
```
|
||
|
||
### 2. 图片过大怎么办？
|
||
|
||
如果复制后提示"图片太大"或粘贴失败：
|
||
1. 降低 `MAX_WIDTH`（如改为 600 或 700）
|
||
2. 降低 `QUALITY`（如改为 0.7）
|
||
3. 或者将大图片分开发送
|
||
|
||
### 3. 图片不够清晰？
|
||
|
||
如果复制后图片显示模糊：
|
||
1. 提高 `MAX_WIDTH`（如改为 1000 或 1200）
|
||
2. 提高 `QUALITY`（如改为 0.85 或 0.9）
|
||
|
||
## 🔧 技术细节
|
||
|
||
### 图片处理流程
|
||
|
||
1. **读取图片** → 2. **判断格式** → 3. **压缩处理** → 4. **Base64 编码** → 5. **生成 HTML**
|
||
|
||
### 特殊格式处理
|
||
|
||
- **SVG**：保持矢量格式，不压缩
|
||
- **GIF**：保留动画，不压缩
|
||
- **PNG/JPG/WebP**：转为 JPEG 并压缩
|
||
- **其他格式**：尝试压缩，失败则保持原样
|
||
|
||
### 为什么转为 JPEG？
|
||
|
||
- JPEG 压缩率高（文件更小）
|
||
- 兼容性好（所有平台都支持）
|
||
- 对于照片和复杂图片效果最好
|
||
|
||
## ❓ 常见问题
|
||
|
||
### Q: 为什么有些平台粘贴后样式消失了？
|
||
A: 某些平台会过滤样式。插件已使用内联样式来提高兼容性。
|
||
|
||
### Q: 图片太小/太大怎么办？
|
||
A: 调整 `DISPLAY_MAX_WIDTH` 参数。
|
||
|
||
### Q: 压缩会影响图片清晰度吗？
|
||
A: 会有轻微影响，但肉眼难以察觉。可以通过提高 `QUALITY` 来改善。
|
||
|
||
### Q: 支持哪些图片格式？
|
||
A: PNG, JPG, JPEG, GIF, WebP, SVG, BMP, TIFF 等常见格式。
|
||
|
||
### Q: 动图会变成静态图吗？
|
||
A: 不会，GIF 动图会保留动画效果。
|
||
|
||
## 📝 更新日志
|
||
|
||
### v2.0.0 (2024)
|
||
- ✨ 新增图片智能压缩功能
|
||
- ✨ 新增图片尺寸限制
|
||
- ✨ 新增可自定义配置
|
||
- ✨ 优化表格支持
|
||
- ✨ 改进 Markdown 转 HTML 转换
|
||
- 🐛 修复图片过大导致复制失败的问题
|
||
- 🐛 修复部分平台样式不兼容的问题
|
||
|
||
### v1.0.0
|
||
- 🎉 初始版本
|
||
- ✅ 基本的图片内嵌功能
|
||
|
||
## 📄 许可证
|
||
|
||
MIT License
|
||
|
||
## 🙋 反馈与支持
|
||
|
||
如有问题或建议，欢迎反馈！
|
||
|