产品简介
markdown-site 面向中文用户,这是一个开源发布框架,专为 AI 代理和开发者设计,用于快速发布网站、文档或博客。用户只需编写 markdown 文件并通过终端同步,内容即可实时更新到所有浏览器、LLM 和 AI 代理,解决了传统发布中内容更新慢、需要重建部署的痛点。适合需要高效内容发布和 AI 集成的技术团队。
核心功能
- AI 代理集成:提供 API 端点、原始 markdown 文件和 MCP server
- 文件发布系统:基于 markdown 的本地写作和版本控制
- 实时内容同步:通过 Convex 实现多浏览器即时更新
- LLM 知识库管理:构建可搜索的 wiki 和知识库
- 管理面板:完整的内容管理和配置界面
快速开始
- 安装 Node.js 18 或更高版本并克隆仓库
- 运行 npm install 安装项目依赖
- 运行 npx convex dev 初始化 Convex 后端
- 运行 npm run dev 启动本地开发服务器
- 编写 markdown 文件并运行 npm run sync 同步内容
界面预览
与其他方案对比
| 对比项 | markdown-site | 同类方案 |
|---|---|---|
| 实时同步能力 | 基于 Convex 的实时数据同步,内容修改后即时可见 | 传统静态站点生成器需要手动重建和部署,更新有延迟 |
| AI 集成优化 | 内置 AI 工具支持,如语义搜索和 MCP server,便于 LLM 发现 | 通常需要额外配置或插件才能实现 AI 集成 |
适合谁用
- 开发者和 AI 代理构建者,需要快速发布网站或文档
- 内容创作者,希望使用 markdown 管理博客并实时同步到线上
- 技术团队,需要多成员协作和实时内容更新
下载与版本
当前最新版本为 main,发布于 。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/waynesutton/markdown-site