入门

阅读约 1 分钟

30 秒上手 md2html。

1. 装

npx @md2html-cli/md2html init

这会生成 article.md、md2html.config.json、.env.example。init 会问你用哪个 LLM provider，按提示选。

2. 配 API key

cp .env.example .env
# 编辑 .env，填入你的 DEEPSEEK_API_KEY（或别的 provider）

或者直接 export：

export DEEPSEEK_API_KEY=sk-...

3. 写 + 编译

打开 article.md，按 语法 写内容。然后：

npx @md2html-cli/md2html build article.md

输出 article.html，浏览器直接打开。

4. 实时预览（可选）

npx @md2html-cli/md2html dev article.md

打开 http://localhost:5173，保存 article.md 浏览器自动刷新。

编译流程

flowchart TD
  A[md 源] --> B[parse 命令块]
  B --> C[engines 并行调 LLM]
  C --> D[渲染产物]
  D --> E[拼装 HTML]
  E --> F[输出]

接下来