القائمة
Markdown到HTML智能转换引擎，支持富文本组件、自动目录生成、多主题模板，专为Agent协作设计。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | nt-md2html |
| version | 2.1 |
| description | Markdown到HTML智能转换引擎，支持富文本组件、自动目录生成、多主题模板，专为Agent协作设计。 |
| 文档 | 用途 | 加载时机 |
|---|---|---|
| widget-syntax.md | 完整组件列表 + 语法 | 生成内容时 |
| widgets.json | 组件定义 | 组件使用 |
| advanced-config.md | 自定义组件 + 高级配置 | 创建自定义组件时 |
| eval.json | 执行评估标准 | 优化执行质量 |
1. 评估内容
└─ 分析 Markdown 内容 → 识别适合的组件类型
2. 组件化
└─ 将纯文本转换为 Widget 语法
3. 检查组件支持
└─ 所需组件存在？
├─ YES → 继续
└─ NO → 创建自定义组件或使用纯 Markdown
4. 渲染
└─ python scripts/render.py --file output.md --output output.html
# 基本渲染
python scripts/render.py --file input.md --output output.html
# 指定主题
python scripts/render.py --file input.md --output output.html --template dark
# 验证组件定义
python scripts/render.py --validate-widgets
# 调试模式
python scripts/render.py --file input.md --output output.html --debug
# stdin模式
echo "# 标题" | python scripts/render.py > output.html
必须输出两个文件：
{name}.md - 源文件（AI可读，可编辑）{name}.html - 最终文件（人类可读）# 后必须有空格，层级应从 #（h1）开始逐级递增，不可跳级（如 h1 → h3）-，有序列表用 1.，列表项之间用空行分隔``` 包裹代码块并指定语言（如 ```python），行内代码使用单反引号|---|---| 分隔，列对齐用 :---（左）、:---:（居中）、---:（右）[文本](url) 和  格式，URL 无需额外引号**粗体**（偶数个 **）、*斜体*（偶数个 *），不可混用---，前后需空行，避免与标题语法冲突::: 开头和闭合，嵌套时外层用 :::、内层用 ::::（递增冒号数量）@组件名[内容]{属性="值"}，属性值必须使用双引号key1="value1", key2="value2"status-report、milestone-card::: 标记前后建议各空一行，确保解析正确widgets: 中定义，或加载 advanced-config.md| 常见错误 | 正确写法 | 说明 |
|---|---|---|
#标题（无空格） | # 标题 | # 后必须加空格 |
**文字（不闭合） | **文字** | 粗体标记必须成对出现 |
:::card 后不闭合 | :::card ... ::: | 围栏组件必须闭合 |
| 嵌套冒号数相同 | 外层 :::，内层 :::: | 嵌套时冒号数递增 |
key='value' 单引号 | key="value" | 属性值必须用双引号 |
{} 内无空格 | {key="val"} | 属性紧贴大括号，无多余空格 |
| 标准 mermaid 代码块 | :::mermaid 语法 | 使用 Widget 语法渲染 |
| 组件名大小写混用 | status-report 全小写 | 组件名统一用小写+连字符 |
1. 分析现有内容结构
2. 评估是否需要组件化
3. 如需组件化，修改.md文件添加Widget语法
4. 执行渲染命令
1. 规划内容结构
2. 加载组件规格（references/widget-syntax.md）
3. 使用Widget语法编写Markdown
4. 执行渲染命令
| 场景 | 推荐 |
|---|---|
| 已有 Markdown 文件需要渲染 | ✅ |
| 内容复杂度中等或以上 | ✅ |
| 需要并行处理提升效率 | ✅ |
| 简单的单次转换 | ❌ |
| 需要实时交互反馈 | ❌ |
[NTMD2HTML_DELEGATE]
task: render
input: {文件路径或内容}
theme: {default|dark}
output: {输出路径}
load_full_specs: true
widget-syntax.md（完整组件列表）widgets.json（组件定义）| 内容类型 | 推荐组件 |
|---|---|
| 信息容器 | card |
| 操作引导 | btn |
| 数据展示 | progress / stats / metric-card |
| 对比布局 | columns / comparison |
| 导航跳转 | toc |
| 步骤流程 | steps / step |
| 特色展示 | features / feature |
| 时间线 | timeline / timeitem |
| 看板 | kanban / kancol / ticket |
| 交互弹窗 | modal / panel |
| 代码展示 | terminal |
| 引用块 | quote |
| 提示强调 | callout / alert |
| 标签徽章 | badge / beta |
| 悬浮提示 | tooltip |
| 键盘按键 | kbd |