sitemd

使用 MCP 工具，从 Markdown 构建网站。可作为 OpenClaw 技能或插件运行——你的 agent 可通过自然对话创建、管理和部署网站。

入门步骤

1. 若无二进制文件（即 sitemd/sitemd 不存在）——运行 ./sitemd/install 下载二进制文件
2. 调用 sitemd_status 查看当前项目状态
3. 若为全新项目——先阅读 pages/ 目录下的文件，再使用 sitemd_pages_create 创建页面
4. 调用 sitemd_site_context 并传入内容类型（content type），获取站点身份标识、约定规范及现有页面列表
5. 使用 sitemd_content_validate 验证内容质量
6. 使用 sitemd_deploy 部署网站

认证机制

sitemd 使用邮箱魔法链接（email magic links）进行登录。当你的所有者需要登录时：

1. 调用 sitemd_auth_login —— 返回一个浏览器可访问的 URL
2. 将该 URL 以消息形式发送给所有者（如 WhatsApp、Telegram、Discord 等）
3. 所有者点击链接，并在浏览器中完成登录流程
4. 每隔几秒调用一次 sitemd_auth_poll，直至返回 approved

对于自动化部署，请使用 sitemd_auth_api_key 创建长期有效的 API 密钥，然后在环境中设置 SITEMD_TOKEN。

项目结构

• sitemd —— 编译后的二进制文件（运行 ./sitemd/sitemd launch 启动）
• install —— 引导脚本（运行 ./sitemd/install 下载二进制文件）
• pages/ —— 带 YAML frontmatter 的 Markdown 内容文件
• settings/ —— 站点配置（以 YAML frontmatter 形式写在 .md 文件中）
• theme/ —— CSS 样式与 HTML 模板
• media/ —— 图片及其他静态资源
• site/ —— 构建输出目录

MCP 工具

读取 pages、settings 和 groups 文件可直接操作文件系统——无需调用任何 MCP 工具。

配置文件

所有配置均位于 settings/*.md 文件的 YAML frontmatter 中：

内容类型

sitemd 支持结构化内容生成。调用 sitemd_site_context 并指定内容类型，即可获取对应的内容规范与现有页面列表。语法参考如下：

• page —— 通用页面。采用第二人称、现在时态，开篇即突出对读者的价值。
• docs —— 文档类内容。使用祈使语气，明确说明需执行的操作，包含代码块与表格。
• blog —— 博客文章。观点鲜明，需标注日期，长度建议为 400–1200 字。
• changelog —— 更新日志。简洁扼要，按 “Added / Changed / Fixed / Removed” 分类组织。
• roadmap —— 产品路线图。按 “Shipped / In Progress / Planned” 分类组织。

Markdown 扩展语法

除标准 Markdown 外，sitemd 还支持丰富的组件语法。参考如下：

• button: Label: /slug —— 样式化按钮。支持修饰符：+outline、+big、+newtab、+color:red
• card: Title / card-text: / card-image: / card-link: —— 响应式卡片网格
• embed: URL —— 自动识别 YouTube、Vimeo、Spotify、X（原 Twitter）、CodePen 等嵌入源
• gallery: 后接缩进的 ![alt](url) —— 支持灯箱（lightbox）的图片网格
• image-row: 后接缩进的 ![alt](url) —— 等高图片横排布局
• ![alt](url +width:N +circle +bw +expand) —— 图片修饰符（宽度、圆形裁剪、黑白、展开等）
• [text]{tooltip content} —— 行内提示框（tooltip）
• modal: id 后接缩进内容，通过 [link](#modal:id) 触发 —— 模态对话框（modal dialog）
• {#custom-id} —— 行内锚点
• [text](url+newtab) —— 链接修饰符
• form: 后接缩进的 YAML —— 表单定义
• gated: type1, type2 ... /gated —— 受限访问区块（gated sections）
• data: source / data-display: cards|list|table —— 动态数据渲染（支持卡片、列表、表格三种视图）