# 文件
您可以将文件上传到您的 GitBook 空间，并将它们添加到页面中供他人查看或下载。
您可以在页面上直接展示某些文件，例如图片和 OpenAPI 文件，供用户查看而无需点击任何内容。对于其他文件，例如 PDF，用户需要点击后才能查看或下载。
如果需要，您还可以选择在插入到页面中的任何文件下方添加说明文字，以提供更多信息。
### 文件示例
{% file src="/files/8baa695d9855e2732e0d9da5d1d738fce6871f61" %}
这是文件的说明文字。
{% endfile %}
### 上传文件
您可以在空间的文件侧边栏中管理已上传的文件。您可以在空间目录顶部找到“文件”面板。
要上传文件，请将其拖放到 **拖放文件或浏览** 区域，或者选中它并使用系统文件对话框选择要上传的文件。
{% hint style="warning" %}
GitBook 允许您每个文件上传最多 100MB。
{% endhint %}
当您添加 [图片块](/docs/documentation/zh/creating-content/blocks/insert-images.md) 或 [OpenAPI 块](/docs/documentation/zh/api-references/openapi.md)时，也可以将文件添加到您的空间中。当您创建这些块中的任意一个时，文件面板会打开，您可以选择一个文件，或上传一个新文件。
{% hint style="info" %}
**提示：** 您还可以直接从文件系统将图片拖放到编辑器中，或者将复制的图片粘贴到内容中。GitBook 会自动将它们添加到相应空间的文件侧边栏中，方便您日后查看和管理。
{% endhint %}
### 重命名文件
要重命名文件，请打开该文件的 **操作菜单** ，然后点击 **编辑**。在对话框提示中，输入文件的新名称。
### 删除文件
要删除文件，请打开该文件的 **操作菜单** 并点击 **删除**。在确认对话框中确认您确定要删除该文件后，文件将被删除。
{% hint style="warning" %}
**注意：** 请务必更新所有包含已删除文件的页面！引用已删除文件的文件块将显示为空块，或者 *无法加载图片* 错误。
{% endhint %}
### 替换文件
如果某个文件只是需要更新到新版本，您可以替换它。这将用新文件替换旧文件。此前引用旧文件的任何块随后都会引用新文件。
要替换文件，请打开该文件的 **操作菜单** 并点击 **替换**。在出现的文件替换对话框中，选择新文件并等待上传指示完成。您的文件将自动在空间中出现的所有位置更新。
例如，如果您进行了重大产品重新设计，并且需要更新出现在多个页面上的过时 UI 截图，这会很有帮助。替换原始文件将更新您空间中所有位置的截图，节省您的时间和精力。
{% hint style="info" %}
**提示：** 一旦您上传了图片或文件，您就可以通过创建图片或文件块并从 **文件** 侧边栏
中选择它，在空间中的任何位置引用它。我们建议您这样做，而不是每次需要包含它时都重新上传图片，这样以后更容易替换图片，并且可以避免出现多个同名文件。
{% endhint %}
### Markdown 中的表示
```markdown
{% file src="https://example.com/example.pdf" %}
这是示例文件的说明文字。
{% endfile %}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://gitbook.com/docs/documentation/zh/creating-content/blocks/insert-files.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.