文件

管理并向你的空间添加文件，例如 PDF、视频、文档等

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

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

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

文件示例

2MB

example.pdf

PDF

打开

这是文件的说明文字。

上传文件

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

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

GitBook 允许您每个文件上传最多 100MB。

当您添加 图片块 或 OpenAPI 块时，也可以将文件添加到您的空间中。创建这些块中的任意一种时，Files 面板将会打开，因此您可以选择一个文件，或者上传一个新文件。

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

重命名文件

要重命名文件，请打开该文件的 操作菜单 ，然后点击 编辑。在弹出的对话框中，输入文件的新名称。

删除文件

要删除文件，请打开该文件的 操作菜单 并点击 删除。在对话框中确认您确实要删除该文件后，文件将被删除。

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

替换文件

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

要替换文件，请打开 操作菜单 并点击 替换。在出现的文件替换对话框中，选择新文件并等待上传指示完成。您的文件将在其出现在空间中的所有位置自动更新。

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

提示： 一旦您上传了图片或文件，您就可以通过创建图片或文件块，并从 文件 侧边栏

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

在 Markdown 中的表示

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