文件

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

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

您可以在页面本身显示某些文件，例如图像和 OpenAPI 文件，让人们无需点击即可查看。对于其他文件（例如 PDF），用户需要点击才能查看或下载。

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

文件示例

2MB

example.pdf

pdf

这是文件的说明文字。

上传文件

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

要上传文件，请将其拖放到 放入您的文件或浏览 部分，或选中该部分并使用系统文件对话框选择要上传的文件。

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

当您添加以下内容时，也可以将文件添加到您的空间： 图像块 或一个 OpenAPI 块。当您创建这些块之一时，文件面板会打开，您可以选择文件或上传新文件。

提示： 您也可以直接将图像从文件系统拖放到编辑器中，或将复制的图像粘贴到内容中。GitBook 会自动将它们添加到相应空间的“文件”侧边面板，方便您稍后查看和管理。

重命名文件

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

删除文件

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

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

替换文件

如果某个文件只需要更新为新版本，您可以替换它。这将替换旧文件并将新文件放在其位置。之前引用旧文件的任何块随后将引用新文件。

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

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

提示： 上传图像或文件后，您可以通过创建图像块或文件块并从 文件 侧边面板中选择它，在空间中的任何位置引用它。

我们建议您这样做，而不是每次包含图像时都重新上传，以便日后更容易替换图像并避免出现多个同名文件。

在 Markdown 中的表示

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