文件

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

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

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

你也可以在页面中插入任何文件时可选地在其下方添加说明文字，以在必要时提供更多信息。

文件示例

2MB

example.pdf

PDF

打开

这是文件的说明文字。

上传文件

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

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

GitBook 允许你每个文件上传不超过 100MB 的文件。

当你添加 图像块 或一个 OpenAPI 块时，你也可以将文件添加到你的空间。创建其中一个块时，文件面板将打开，这样你可以选择一个文件或上传一个新文件。

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

重命名文件

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

删除文件

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

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

替换文件

如果你的文件只是需要更新为新版本，你可以替换它。这样会用新文件替换旧文件。任何之前引用旧文件的块随后将引用新文件。

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

例如，如果你的产品经历了重大改版，需要更新出现在多页上的过时 UI 截图，这会很有帮助。替换原始文件会在空间中的所有位置更新截图，为你节省时间和精力。

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

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

在 Markdown 中的表示

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