写文档的人大概都经历过这种瞬间——浏览器里打开在线 Markdown 编辑器,正敲到关键段落,网络断了,页面白屏;又或者写完一段代码示例,想从预览区复制出来,结果只能手动选中、拖鼠标,漏一个字符就编译不过。
StackEdit v6.0.10 这版更新,恰好把这两个痛点各戳了一下。
修了什么
这次更新三条内容,每一条都指向实际使用中的摩擦:
PWA 线打开失败修复。 StackEdit 本身支持 Progressive Web App,安装后可以像本地应用一样离线使用。但之前版本存在一个 bug:离线状态下打开 PWA 会失败,直接打不开页面。v6.0.10 修复了这个问题,离线场景下 PWA 可以正常加载和编辑。
图片点击放大优化。 Markdown 文档里插入图片后,预览区点击图片会放大查看。这次对放大交互做了优化,体验更流畅,细节上更接近常见图片查看器的行为。
支持代码块复制。 这是最实用的改动——预览区渲染出来的代码块,现在带了一个复制按钮,点击即可将代码内容复制到剪贴板,不用再手动拖选。
三条改动都不大,但每一条都是"用过就知道缺"的那种。
代码块复制:小按钮,大省事
之前在 StackEdit 里写技术文档,预览区渲染的代码块没有复制功能。读者想拿代码去跑,只能手动选中复制,遇到长代码块尤其痛苦——滚动区域选文字,稍一抖就选错。
v6.0.10 在渲染的代码块右上角加了一个复制按钮,点击直接复制整段代码到剪贴板。写文档的人只需要正常写 Markdown:
## 快速排序示例
```python
def quicksort(arr):
if len(arr) <= 1:
return arr
pivot = arr[len(arr) // 2]
left = [x for x in arr if x < pivot]
middle = [x for x in arr if x == pivot]
right = [x for x in arr if x > pivot]
return quicksort(left) + middle + quicksort(right)
print(quicksort([3, 6, 8, 10, 1, 2, 1]))
预览区渲染后,代码块右上角出现复制按钮,读者一键拿到完整代码,不用再跟滚动条搏斗。
## 本地跑一个 StackEdit
想自己部署体验,最快的方式是用 Docker。项目在 Gitee 上托管(`mafgwo/stackedit`),拉下来跑一遍:
```bash
# 克隆项目
git clone https://gitee.com/mafgwo/stackedit.git
cd stackedit
# 用 Docker Compose 启动
docker compose up -d
如果没有 Docker,也可以用 npm 本地构建:
# 安装依赖
npm install
# 开发模式启动,默认监听 localhost:8080
npm start
启动后浏览器打开 http://localhost:8080,就能看到编辑器界面。写一段带代码块的 Markdown,切换到预览视图,确认代码块右上角出现了复制按钮——这就是 v6.0.10 的新功能。
如果想体验 PWA 离线修复,在 Chrome 中打开页面后,地址栏右侧会出现"安装"图标,点击将 StackEdit 安装为 PWA。安装完成后断开网络,再从桌面或应用列表打开 StackEdit,页面应该能正常加载(之前版本会直接失败白屏)。
PWA 离线修复意味着什么
在线编辑器最大的顾虑就是"没网就没工具"。PWA 的核心价值是把应用资源缓存到本地,Service Worker 拦截请求,离线时从缓存加载页面和核心逻辑。
之前 StackEdit 的 PWA 离线打开失败,说明 Service Worker 的缓存策略或注册时机有缺陷——可能是缓存列表遗漏了关键资源,也可能是离线 fetch 事件没有正确回退到缓存。v6.0.10 修复后,离线打开不再白屏,意味着:
- 出差途中、会议现场等无网环境也能正常编辑
- 配合本地存储(IndexedDB / localStorage),文档不会因为断网丢失
- PWA 安装后体验更接近本地应用,而不是一个"必须联网才能用的网页"
更新建议
如果你正在用 StackEdit 写技术文档或团队知识库,这版值得升级,理由很简单:
- 代码块复制直接提升文档读者的体验,尤其是技术文档,代码可一键取走
- PWA 离线修复让编辑器在断网场景下不再瘫痪,可靠性上了一个台阶
- 图片放大优化是锦上添花,写带大量截图的文档时更顺手
升级方式:Docker 部署的重新拉取最新镜像重启;npm 部署的拉取最新代码后重新 npm install && npm start。已有文档和数据不受影响,升级后即可使用新功能。
一个复制按钮、一个离线修复,改动不大,但都是"用了就回不去"的那种。