Blume 选用指南:把 Markdown 变成站点前,先给旧链接留条路

用三张自造文档卡核对静态站点迁移后的页面、目录和深链接,不把新构建成功当作迁移完成。

来源: useblume.dev
2026年9月13日
1 min

如果团队原本就用 Markdown 写产品文档,但希望沿用自己选择的托管,useblume.dev 的 Blume 是可评估的静态文档框架。它的 Telemetry 案例记载首版文档于 2026 年 8 月 7 日提交,并说明该站点把文档构建为可单独托管的静态文件。首发案例支持新站部署的可行性,不替你证明旧目录和链接会自动保留。

做一张纸面迁移表,不运行构建、不部署。设三张原创卡片为「起步」「安装」「升级」,旧支持文档指向「安装」页里的「检查版本」。让同事从首页按目录找到该段,再从旧地址走一次;若新页能打开但没有到达原段,仍不算通过。把旧地址、预期落点、未通过时恢复旧站点的责任人写在同一张表。

新站没有外部书签时可以先做小规模验证;有旧链接被广泛引用时,要把重定向、标题锚点和回退成本一起算。开源不等于免去构建维护。采购或迁移前核对静态产物是否适合现有托管,并要求保留原 Markdown 与地址清单。如果旧站现在就能稳定维护,且维护负担没有实质减少,就别为了换框架搬。

内容说明:本文基于公开资料整理,仅供工具选型参考。产品功能、价格及相关政策可能随时调整,请以官方最新信息为准。

原文出处:useblume.dev