语法
md2html 是 扩展的 markdown — 普通 markdown 全部保留,多两种结构:命令块 ::: 和命名数据块 @。
命令块
3-冒号围栏,第一行 /命令名 起头:
::: /插入图表 引用@销售
柱状图 X 季度 Y 销售
高亮 Q4
:::
围栏里:
- 第一行:
/命令 [args...] 引用@xxx:特殊参数,指向数据块。xxx 不能含空格- 一个命令可以多个
引用@ - 后续行:自然语言 body
命名数据块
@名字 起头的可被 引用@ 的块:
解析顺序:
- 同文件内查找同名
@xxx - 找不到 → 同目录查
xxx.csv/xxx.json/xxx.md - 还找不到 → 报错
5 个内置命令
/插入表格
| 季度 | 销售额 |
|---|---|
| Q1 | 100 |
| Q2 | 120 |
| Q3 | 140 |
| Q4 | 180 |
不调 LLM,纯数据 → HTML 表。
/插入图表
LLM 把描述 + 数据 → Vega-Lite spec → 浏览器交互渲染。
/插入流程图
flowchart TD
A[账号密码输入] --> B{校验}
B -->|成功| C[跳转首页]
B -->|失败| D[提示错误]
LLM 出 Mermaid 代码 → 浏览器渲染。
/插入插图
调用 image API(智谱 CogView / Gemini Imagen / OpenAI gpt-image-1)生成 PNG/JPEG。
/插入交互
LLM 从 4 个内置 widget(filterable-table / tabs / slider-calc / accordion)选一个 + 填配置 → 浏览器渲染。