SuperAPI AI 工具集

markdown-spec-to-page

前端与建站

查看项目

更新于 10-15 20:11

技能介绍

用途:解析结构化 Markdown 规格文档,生成完整的 Nuxt 3 落地页,使用 RDS Vue UI 组件。当用户提供 Markdown 文件或文本时使用。

主要能力:把单个 Markdown 规格转换为两个输出文件:pages/<page-name>.vue(Nuxt 3 页面组件)与 assets/content/<page-name>.json(结构化内容数据)。规格中可显式指定组件,未指定时依据章节名称与内容通过 rds-component-mapper 决策树推断最匹配组件。

规格格式:一级标题 # Page Title 设置页面标题与 meta;每个二级标题 ## Section Name 成为一个页面章节;- component: xxx 指定 RDS 组件(kebab-case);- items: 表示重复组件列表;- layout: N-column grid 用 Bootstrap row/col-md-* 网格包裹;其余 - key: value 成为组件 props 或内容 JSON 字段。

组件解析:显式组件由 kebab-case 转为 PascalCase,如 hero-standard-apollo 对应 HeroStandardApollo。未指定时按章节名推断,如 Hero/Banner 推断 HeroStandardApollo,About/Overview 推断 SectionApollo,Programs/Courses 推断 CardImageArticle 网格,FAQ 推断 OverlapAccordionAtlas,Stats 推断 SectionStatApollo,Footer 推断 FooterStandard;无匹配则默认 SectionApollo。

工作流:解析规格、提取章节键值对、解析组件、处理 items 与网格、生成页面与内容文件,最后输出生成报告(章节数、所用组件、来源、警告)。

网格:N 列对应 col-12、col-md-6、col-md-4、col-md-3、col-md-2;有 items 但未指定布局时默认 3 列。

错误处理:无页面标题用文件名;无章节报错;未知组件警告并跳过;缺必需 props 用占位值;空 items 警告;重名章节追加数字后缀。

限制:依赖 RDS Vue UI 组件与 Nuxt 3 环境;组件推断基于内置映射表,未覆盖的章节回退为通用内容块。具体安装与运行命令资料未提供。