docxtemplater

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

开源 🏷️基础免费,高级付费 ✅ 目前可打开 办公效率 🍴 复刻 385 🐛 待处理 5 👀 关注 80
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 3653
维护状态 维护中
是否开源 开源
定价模式 🏷️基础免费,高级付费 支持限时试用 · 开源库免费,云服务/商业授权付费,提供在线Demo试用

项目预览

docxtemplater 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类办公效率
开发团队open-xml-templating
定价模式🏷️基础免费,高级付费
价格说明开源库免费,云服务/商业授权付费,提供在线Demo试用
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言JavaScript
技术栈/模型docx,docx-generation,docx-generator,docx-template,excel,javascript,microsoft,office,powerpoint,pptx,template,word,xlsx
GitHub 星标★ 3653
上线时间2013-05-16 00:00:00
代码更新2026-10-15
仓库体积40.1 MB
本站数据更新2026-11-21
维护状态维护中
收录时间2026-10-06
浏览次数3

项目介绍

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

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-10-06 · 当前星标 ★ 3653

使用教程

难度:入门 约 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

上一篇:integrations

下一篇:py-idp

同类项目推荐

simpledms 开源

小团队自建文档库,资料集中存、按标签秒查

Document management for small businesses.

★ 170 2026-10-18
opensync 开源

把 AI 编程会话同步上云,随时搜、随时导出评测

Cloud-synced dashboards for OpenCode and Claude Code. Track sessions, search with se···

★ 413 2026-10-01
QOwnNotes 开源

用纯文本文件管理笔记和待办,轻松同步到 Nextcloud

QOwnNotes is a plain-text file notepad and todo-list manager with Markdown support a···

★ 5971 2026-08-09
Invoice-Downloader 开源

自动从邮箱抓发票,OCR 识别后一键生成报销 Excel

电子发票整理与报销准备工具:从邮箱批量收集 PDF/OFD/XML 发票,OCR 识别、分类归档并生成···

★ 555 2026-09-29
convenient_window_free 开源

鼠标划到屏幕边角,分屏截图取字一步到位

Windows 11 desktop enhancer for hot zones, edge hiding, window layouts, mouse gestur···

★ 199 2026-11-08
suite 开源

一个入口收拢零散效率小工具,少切应用多干活

[WIP] Original, intentionally designed productivity tools

★ 123 2026-10-20
PasteMD 开源

复制 AI 对话,粘贴进 Word/Excel,格式不乱码

一键将 Markdown 和网页 AI 对话(ChatGPT/DeepSeek等)完美粘贴到 Word、WPS 和 Excel 的···

★ 5445 2026-08-09
AI-MarkDone 开源

把 AI 对话变成可标注、可导出的知识文档

ChatGPT directory navigation, Reader source copy, Dynamic Annotation, bookmarks, PNG···

★ 212 2026-08-09