生成文档

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

生成单份文档

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

批量生成

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

1. 选择模板。
2. 在多维表格中，勾选需要生成的多条记录。
3. 点击生成 N 份文档（按钮会显示已选记录的数量）。一次最多 500 条记录。
4. 生成完成后逐份下载；如果在模板标签页配置了自动保存，也会自动写回飞书。

如需用所有选中的记录生成一份文档（列表、每条记录一页或标签），请参见多条记录生成一份文档。

注意

免费版每次生成前会等待 30 秒，且整个企业每分钟最多生成 2 次。 席位可为其持有人取消这两项限制，专业版则为所有人取消。

保存到附件字段

需要席位（Starter 或 Business）或专业版。

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

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

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

输出格式：DOCX、PDF 或 PNG

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

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

三种格式在所有套餐（包括免费版）中均可使用，且每份文档都只计一次生成。Excel 或 PowerPoint 模板会生成同类文件或 PDF，参见 Excel 和 PowerPoint 模板。

状态字段

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

动态文件名

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

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

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

查看可用字段

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