docxtemplater

用 Word 模板 + JSON 数据,一键生成批量文档

docxtemplater 是一个基于 JavaScript 的模板引擎,用于从 Word、PowerPoint 和 Excel 模板生成 docx、pptx、xlsx 文档。它解决了程序化生成复杂办公文档的痛点:传统方式需要逐行操作 Office API,繁琐且易出错。核心能力包括:使用 {name} 等占位符替换文本、循环渲染表格行、条件显示内容、插入图片、HTML 片段和图表;支持 Node.js 和浏览器环境,兼容 React、Vue、Angular 等前端框架。模板由用户在 Office 中设计,开发者只需提供 JSON 数据,即可批量生成合同、报告、发票等文档,大幅降低开发成本。项目提供免费开源版本,高级功能如 HTML 模块、图表模块需付费授权。

开源 freemium 办公效率
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 3634
维护状态 较活跃
是否开源 是
定价模式 freemium

项目预览

项目数据

分类办公效率
开发团队open-xml-templating
所属国家
定价模式freemium
价格说明开源库免费,云服务/商业授权付费,提供在线Demo试用
访问状态
是否开源是
开源协议NOASSERTION
主要语言JavaScript
技术栈/模型docx,docx-generation,docx-generator,docx-template,excel,javascript,microsoft,office,powerpoint,pptx,template,word,xlsx
GitHub 星标★ 3634
30天Star增速
HF 下载量
上线时间2013-05-16 00:00:00
代码更新—
仓库体积—
本站数据更新—
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-10-06
浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度:入门 约 10 分钟 部署方式:库/依赖 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 环境(README 提供 nodejs 快速开始)
  • 可编辑 docx/pptx 模板的 Office 软件(Word/PowerPoint)
  • 与占位符对应的 JSON 数据
  • 浏览器环境需配合 React、Angular、Vue 或 Next.js 使用

安装与启动步骤

  1. 1阅读官方快速开始

    README 未给出安装命令,先打开官网 Node.js 或浏览器快速开始文档,按其中指引安装配置。

  2. 2准备 Office 模板

    在 Word 或 PowerPoint 中设计模板,用 {placeholder} 形式写占位符,模板可由非程序员编辑。

  3. 3编写模板语法

    按需使用循环 {#users}{name}{/users}、条件判断,或在表格中循环生成列。

  4. 4准备 JSON 数据

    提供与占位符名称一致的 JSON 数据,用于替换文本、驱动循环与条件渲染。

  5. 5生成文档

    在 Node.js 或浏览器端用该库渲染模板,输出 docx/pptx 文件;示例见官网 Demo。

  6. 6了解付费模块

    插入图片、自定义 XML 等能力由官方付费模块提供,需要使用时可单独购买接入。

如何确认成功

按官网快速开始文档跑通示例后,生成的 docx/pptx 中占位符被 JSON 数据正确替换。

常见问题

Q:模板必须由程序员制作吗?

A:不需要。模板可在 Word/PowerPoint 等 Office 软件中编辑,非程序员(例如你的客户)也能自行维护占位符和版式。

Q:支持哪些运行环境?

A:支持 Node.js 以及浏览器端,官方提供 React、Angular、Vue、Next.js 的浏览器快速开始文档。

Q:插入图片、图表要额外付费吗?

A:README 中列出的功能模块(如 Image module)属于付费模块,需要在基础库之外单独获取并接入。

Q:怎么安装这个库?

A:README 节选没有给出安装命令,请到官网 https://docxtemplater.com/docs 的快速开始页面按 Node.js 或浏览器方式安装。

Q:从旧版本升级要注意什么?

A:README 指向 CHANGELOG.md,迁移与版本变更说明以该文件为准。

注意事项

  • README 节选未提供任何安装命令与版本号,本教程步骤均为通用准备动作,具体命令请查阅官网文档。
  • 循环、条件、原始 XML 插入等用法可在官网 Demo 站点(docxtemplater.com/demo)逐个查看。
  • 部分高级功能属于官方付费模块,使用前请确认授权。
  • 从旧版本迁移请参考仓库中的 CHANGELOG.md。

核心亮点

  • 模板语法直观,支持循环、条件、图片、HTML 等复杂场景
  • 同时支持 Node.js 和浏览器,前端可直接生成并下载文档
  • 与主流前端框架集成简单,社区示例丰富

不足之处

  • 高级功能(HTML、图表、图像模块)需付费授权,免费版功能受限
  • 文档主要依赖官网,GitHub 仓库内文档较少,新手上手需一定学习成本

适用场景

  • 批量生成合同、发票、工资单等标准化文档
  • 根据数据库数据自动生成周报、月报等业务报告
  • 在 Web 应用中让用户在线填写表单后导出 Word/Excel 文件

替代项目

docx、officegen

项目介绍

docxtemplater 是办公效率领域的开源项目,由 open-xml-templating 开发,2013 年首次发布。

在全站 13,752 个收录项目中,它的 GitHub 星标数(3,634)位列前 30%,在办公效率分类中处于中上游。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-21。开源库免费,云服务/商业授权付费,提供在线Demo试用。

它主要面向的使用场景是:批量生成合同、发票、工资单等标准化文档。同类可对比的替代方案包括 docx、officegen。

上一篇:integrations

下一篇:py-idp

同类项目推荐

sunshine-control-panel 开源

一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。

Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···

★ 446 2026-08-09
Stirling PDF 开源

本地部署 PDF 工具箱

#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere

★ 93614 2026-08-19
obsidian-md2wechat 开源

一键将 Obsidian 笔记排版成公众号文章,告别手动调格式

Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···

★ 317 2026-08-09
pdf2md 开源

浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。

Browser based tool to convert PDFs to Markdown

★ 381 2026-08-09