生成文档

您可以生成单份文档，也可以一次性为多条记录批量生成。

生成单份文档

1. 打开生成页面（插件首页）。
2. 从下拉列表中选择模板。
3. 在多维表格中，勾选某条记录前的复选框。
4. 点击生成文档按钮——按钮下方会显示所选记录的名称。
5. 生成完成后点击下载。

批量生成

一次性为多条记录生成文档：

1. 选择模板。
2. 在多维表格中，勾选需要生成的多条记录。
3. 点击批量生成按钮（选中多条记录时出现）。
4. 生成完成后逐份下载——如果在模板标签页配置了自动保存，也会自动写回飞书。

注意

免费版每次生成前会等待 30 秒，且整个企业每分钟最多生成 2 次。 专业版取消这两项限制。

保存到附件字段（专业版）

将生成的文档自动写回您的多维表格：

1. 在模板标签页启用保存到多维表格。
2. 选择目标附件字段。
3. 选择写入方式：追加到原始附件或替换原始附件。

非常适合归档文档、触发自动化流程，或让文档与源数据保存在一起。

输出格式：DOCX、PDF 或 PNG

模板默认生成 Word 文档。在模板标签页中，通过输出格式可切换为：

• PDF 文档 (.pdf) —— 由生成的 DOCX 转换而来。
• 图片 (.png) —— 仅渲染文档首页，适合用作缩略图或预览。

三种格式在所有套餐（包括免费版）中均可使用，且消耗的生成次数相同。

状态字段（专业版）

模板可以把生成进度写回飞书字段，这样多维表格中每条记录旁都能显示生成状态：先是 ⏳ Processing，随后是带文件名的 ✅ Completed、⚠️ Completed with warnings，或以 ❌ 开头的错误信息。在模板标签页的**状态字段（可选）**中配置。参见专业版功能。

动态文件名

使用变量模式生成规范的文件名：

• Invoice_{Invoice_Number}.docx → Invoice_INV-2024-001.docx
• Report - {Customer_Name} - {Date}.docx → Report - Acme Corp - 2024-01-15.docx

在模板标签页配置文件名模式。该模式支持与模板正文相同的占位符——参见模板语法。

查看可用字段

生成之前，请访问变量页面查看所有可用字段及其准确名称，确保模板中的占位符与多维表格的字段名完全一致——可写的语法参见模板语法；若占位符未被替换，请参见变量未被替换。