# 文件

您可以将文件上传到您的 GitBook 空间，并将它们添加到页面中，供他人查看或下载。

您可以将某些文件（例如图片和 OpenAPI 文件）直接显示在页面上，让用户无需点击任何内容即可查看。对于其他文件，例如 PDF，用户则需要点击才能查看或下载。

如果需要，您还可以选择在插入到页面中的任何文件下方添加说明文字，以提供更多信息。

### 文件示例 <a href="#example-of-a-file" id="example-of-a-file"></a>

{% file src="<https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-9ff1c1eef1d9ee1744295e274d3ee01fae848a20%2Fexample.pdf?alt=media>" %}
这是文件的说明文字。
{% endfile %}

### 上传文件

您可以在空间的 Files 侧边栏中管理已上传的文件。您可以在空间目录的顶部找到 Files 面板。

要上传文件，请将其拖放到 **将文件拖到此处，或浏览** 区域，或者选中它并使用系统文件对话框选择要上传的文件。

{% hint style="warning" %}
GitBook 允许您每个文件上传最多 100MB。
{% endhint %}

当您添加 [图片块](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks/insert-images) 或 [OpenAPI 块](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/api-references/openapi)时，也可以将文件添加到您的空间中。创建这些块中的任意一种时，Files 面板将会打开，因此您可以选择一个文件，或者上传一个新文件。

{% hint style="info" %}
**提示：** 您也可以直接从文件系统将图片拖放到编辑器中——或者将复制的图片粘贴到内容中。GitBook 会自动将它们添加到相应空间的 Files 侧边栏中，因此您可以稍后查看和管理它们。
{% endhint %}

### 重命名文件

要重命名文件，请打开该文件的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> ，然后点击 **编辑**。在弹出的对话框中，输入文件的新名称。

### 删除文件

要删除文件，请打开该文件的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并点击 **删除**。在对话框中确认您确实要删除该文件后，文件将被删除。

{% hint style="warning" %}
**注意：** 请务必更新任何包含已删除文件的页面！引用已删除文件的文件块将显示为空白块，或者显示 *无法加载图片* 错误。
{% endhint %}

### 替换文件

如果您的文件只是需要更新为新版本，您可以将其替换。这将替换旧文件并用新文件取而代之。之前引用旧文件的任何块随后都会引用新文件。

要替换文件，请打开 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并点击 **替换**。在出现的文件替换对话框中，选择新文件并等待上传指示完成。您的文件将在其出现在空间中的所有位置自动更新。

例如，如果您进行了重大的产品重新设计，并且需要更新出现在多个页面上的过时 UI 截图，这将非常有帮助。替换原始文件后，空间中的所有截图都会更新，从而为您节省时间和精力。

{% hint style="info" %}
**提示：** 一旦您上传了图片或文件，您就可以通过创建图片或文件块，并从 **文件** 侧边栏

中选择它，在空间中的任何位置引用它。我们建议您这样做，而不是每次需要使用时都重新上传图片，这样以后更容易替换图片，并且可以避免出现多个同名文件。
{% endhint %}

### 在 Markdown 中的表示

```markdown
{% file src="https://example.com/example.pdf" %}
    这是示例文件的说明文字。
{% endfile %}
```
