CLI 命令
@md2html-cli/md2html 提供 5 个子命令。
init
md2html init
交互式向导,生成示例 article.md + md2html.config.json + .env.example。
build
md2html build article.md [--theme default|academic|minimal] [--inline] [--pdf]
| flag | 说明 |
|---|---|
--theme |
主题选择(默认 default) |
--inline |
asset 全部内联到单 HTML(无外部依赖) |
--pdf |
同时输出 article.pdf(需 puppeteer,本地装一份) |
输出 article.html + (可选)article.assets/ 目录。
dev
md2html dev article.md [--port 5173]
启动本地 server,文件变化自动重编 + 浏览器刷新。
publish
md2html publish article.md --target cloudflare|github|netlify|s3 [--slug my-article]
发布到配置的 target,返回 URL。env 需对应 token / API key 配好。
cache
md2html cache stats # 看缓存命中率 + 估算花费
md2html cache clean # 清空内容寻址缓存
退出码
build 在以下情况退出码非 0:
- 源文件读取失败
- 某个 engine 失败导致出错(HTML 仍会输出,含错误占位)