如果你经常用 Markdown 写笔记、文档或博客,又懒得折腾复杂的静态网站生成器,flowershow 可能会让你眼前一亮。这个开源项目用 TypeScript 编写,基于 Next.js,核心功能简单粗暴:把一堆 Markdown 文件变成可直接访问的网站。更妙的是,它还集成了 AI,可以在文档里加入智能问答或自动摘要。
核心流程:连上 GitHub 就能发版
使用 flowershow 的方式很直接。你只需要一个 GitHub 仓库,里面放好 Markdown 文件,然后在本地或 GitHub Actions 里跑一下 flowershow 的 CLI 工具。工具会自动读取文件结构,生成对应的路由和导航,几秒钟后就能得到一个干净的文档站。也可以搭配 Vercel 或 Netlify 一键部署。
- 支持标准的 Markdown 语法,也支持 HTML 混写
- 自动生成侧边栏和目录树
- 内置搜索功能(基于 Fuse.js)
- 可拖动排序页面(对 wiki 类内容很实用)
AI 集成:不止是展示
flowershow 的 AI 特性不是噱头。它允许你在页面中嵌入 AI 组件,比如让读者直接对文档内容提问,或是自动为长文章生成摘要。底层可以接入 OpenAI 或自部署的模型。这对文档作者来说,能大幅减少用户寻找信息的时间。不过目前 AI 功能需要自己配置 API Key,对完全零基础的用户有一定门槛。
适合谁用?
最适用的人群是独立开发者和小型技术团队。比如你维护了一个开源库,想快速搞一份可搜索、可交互的文档;或者你平时用 Obsidian 记笔记,想把某些笔记公开分享。flowershow 可以让你直接从 Markdown 仓库发布,省去写模板、配置路由的麻烦。
现阶段的短板
作为年轻的开源项目,flowershow 的自定义能力还不够强。如果你想改变网站的整体样式,需要懂一些 Tailwind CSS。此外,它目前主要针对文档类内容,不太适合做复杂的博客或电商页面。如果你需要多级嵌套的目录结构,有时也会遇到渲染小 bug。
总的来说,flowershow 是一个轻量、实用的文档发布工具,尤其是在需要快速搭建一个 AI 增强的文档站时,它比很多同类项目更直接。如果你习惯 Markdown 写作,又不想被复杂的构建流程拖累,值得一试。










评论
暂无评论
成为第一个评论的人