Show HN: Md-tmpl - 强类型 Markdown 模板
Md-tmpl 是一个强类型的 Markdown 模板工具,旨在为 Markdown 文档提供类型安全的模板渲染能力。它允许开发者定义结构化模板,并在编译期检查变量类型,减少运行时错误。该项目在 GitHub 上开源,适合需要生成动态 Markdown 内容的场景。
背景速读
- **md-tmpl** 是一个将 Markdown 文件作为模板、并用外部数据(JSON 等)填充其中占位符的命令行工具,同时保证类型安全(即占位符的类型与数据源匹配,否则报错)。
- 作者 Bernhard "domenukk" 是知名逆向工程工具 Unicorn Engine 的核心贡献者,这次的项目则转向开发者工具链。
- 与常见的模板引擎(如 Jinja、Handlebars)不同,md-tmpl 不引入自创的模板语法,而是直接复用 Markdown 链接语法 `[name][type]` 作为占位符,降低学习成本。
- 类型检查在模板渲染前执行,适合用于需要严格文档自动化的场景(如生成 API 文档、报告或在 CI 流程中确保 Markdown 输出格式正确)。
- 该项目为 Rust 编写,通过 Cargo 安装,目前处于早期阶段(文档和错误信息尚在完善中)。