云游君

云游君是什么

云游君是一套面向内容创作者的静态站点生成工具链。输入 Markdown 或常见文本格式，输出可直接部署的 HTML 静态页面。默认构建产物为纯静态文件，不依赖服务端运行时。

有一点需要注意：项目本身不绑定特定托管服务，构建结果放到任意静态服务器或对象存储都能跑。

云游君主要功能

• 文档解析与渲染：读取 Markdown、MDX 等源文件，经解析器转换为 HTML，输出时保留标题层级与代码块高亮。
• 主题切换机制：设有默认主题与可替换主题包，按配置文件指定主题名，构建时注入对应 CSS 与布局模板。
• 路由生成：根据源文件目录结构自动生成页面路由，输出 index.html 及对应子路径，无需手动维护路由表。
• 构建性能优化：增量构建模式下仅重新编译变更文件，实测在千级页面项目中构建耗时降低约 60%。
• 配置驱动：通过单一配置文件声明站点标题、导航、侧边栏等参数，构建阶段读取并注入模板变量。
• 插件扩展：提供构建钩子，可在解析前后插入自定义处理逻辑，输入原始文件、输出处理后的中间产物。

数据量偏大时。首次全量构建会有明显等待。

云游君使用要求

运行环境为 Node.js，版本要求 16 及以上。低于该版本部分依赖无法安装。

构建过程需要可写文件系统，用于输出临时文件与最终产物。内存建议不低于 2GB，页面数量超过 500 时建议 4GB 以上。

云游君核心优势

构建产物为纯静态文件。部署时不需要 Node 运行时，也不依赖数据库。这是它和动态 CMS 的主要区别。

增量构建机制。改动单个文件只重编该文件相关链路，不触发全量重建。

云游君如何使用

• 安装依赖后在项目根目录执行构建命令，生成 dist 目录。
• 修改配置文件调整站点标题、导航项、主题名。
• 在内容目录新增或编辑 Markdown 文件，重新构建即可生成对应页面。
• 需要自定义样式时，在主题目录替换 CSS 变量或新增样式文件。
• 构建完成后将 dist 目录整体上传至静态托管服务。

云游君同类竞品对比

云游君应用场景

技术文档站点。源文件为 Markdown，构建后输出带侧边栏导航的静态页面。

个人博客。按目录组织文章，路由自动生成，无需手动配置每篇文章路径。

项目说明页。配置文件声明少量页面，构建产物可直接挂到 GitHub Pages 或对象存储。

这里有个细节，增量构建在文件重命名时可能触发相关链路重建，耗时略高于普通编辑。

云游君适用人群

• 需要把 Markdown 批量转成静态页面的开发者
• 维护数百页以上文档、在意构建耗时的团队
• 想用配置文件而非代码定制站点结构的用户
• 部署环境不支持服务端运行时的场景

首页截图