文件

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

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

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

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

文件示例

2MB

example.pdf

PDF

打开

这是文件的说明文字。

上传文件

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

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

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

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

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

重命名文件

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

删除文件

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

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

替换文件

如果某个文件只是需要更新到新版本，您可以替换它。这将用新文件替换旧文件。此前引用旧文件的任何块随后都会引用新文件。

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

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

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

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

Markdown 中的表示

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