Markdown 文档预览服务的小结

平时会生成一些 Markdown 或 HTML 报告，如果每次都发压缩包或截图，查看体验并不好。一个轻量预览服务的价值，就是把文件上传后生成公开链接，直接在浏览器里看最终效果。

上传和访问分开

上传入口需要鉴权，因为它会写入服务器文件；预览链接可以公开访问，因为它本来就是用来分享的。两者边界分清后，服务逻辑会简单很多，也方便以后接入自动化脚本。

文件限制

预览服务不适合无限制接收内容。文件大小、扩展名、保存路径和随机链接都应该有明确约束。文件名只用于显示，不应该直接作为服务器保存路径。

POST /api/shortcut-preview-upload
Authorization: Bearer ***
file: report.md

后续想法

后续可以补充简单的过期策略和管理入口，但核心功能保持克制：上传一份文档，返回一个链接，打开后就是预览效果。