用自然语言写笔记,
agent 时代的发布工具

写 markdown,::: 命令块声明图表 / 流程图 / 插图 / 交互 widget — 工具调 LLM 自动生成,输出可发布 HTML。

npx @md2html-cli/md2html build article.md
Try Playground → Read Docs

能做什么

/插入图表

自然语言描述 → LLM 生成 Vega-Lite spec → 浏览器渲染交互图表。

::: /插入图表 引用@销售
柱状图 X 季度 Y 销售
高亮 Q4
:::

/插入流程图

中文描述流程 → LLM 出 Mermaid → 浏览器渲染。

::: /插入流程图
用户登录:
输入 → 校验 →
成功跳首页/失败提示
:::

/插入交互

LLM 挑 widget + 填 config — 可筛选表格、tabs、滑块计算器。

::: /插入交互 引用@销售
可筛选可排序的销售明细
:::

谁用

🤖 For Agents

MCP server 一行配置,agent 直接调 md2html_build + md2html_publish 出 URL。

{
  "mcpServers": {
    "md2html": {
      "command": "npx",
      "args": ["@md2html-cli/md2html-mcp"]
    }
  }
}

👤 For Humans

CLI + 本地 dev server — 写 markdown,保存自动刷新浏览器。

$ md2html dev article.md
✓ http://localhost:5173

3 步上手

1

npm install -g \
  @md2html-cli/md2html
2

# 我的文章

::: /插入流程图
登录流程:…
:::
3

编译

$ md2html build article.md
✓ article.html