1. 00. 概述
石墨文档中台-开发文档
  • 1. 适用范围
  • 00. 概述
    • 石墨文档中台能做什么?
    • 三种典型的业务接入场景
    • 石墨文档中台支持哪些格式?
  • 01. 快速开始
    • 基本概念
    • 场景一:10 分钟创建预览文件
    • 场景二:10 分钟创建协同编辑文件
  • 02. 鉴权与安全
    • 整体概述
    • 签名凭证 Token
    • 签名凭证 Signature
  • 03. 文件预览
    • 整体概述
    • 如何预热预览缓存
    • 如何防盗链
    • 常见问题处理
  • 04. 文件编辑
    • 整体概述
    • 协同文档权限设计
    • 协同文件保存与更新机制
    • 协同文件复制与删除
  • 05. 文件导入导出
    • 整体概述
    • 常见问题处理
  • 06. 石墨前端 API
    • 整体概述
    • 公共 API
      • 公共处理方法
      • 顶部栏定制 HeaderBars
    • 编辑器 API
      • 轻文档
      • 传统文档
      • 表格
      • 幻灯片
      • 表单
      • 应用表格
  • 07. 石墨后端 API
    • 整体概述
    • 错误码说明
    • 文件-预览 API
      • 访问预览文件
      • 创建文件预览缓存
    • 文件-协同编辑文件管理 API
      • 访问协同编辑文件
      • 创建协同文件
      • 创建协同文件副本
      • 删除协同文件
    • 文件-导入导出 API
      • 文件导入
        • 文件导入说明
        • 创建导入任务
        • 获取导入进度
        • 创建导入任务(旧版)
        • 获取导入进度(旧版)
      • 文件导出
        • 文件导出流程
        • 创建导出任务
        • 获取导出进度
    • 文件-表格文件(Excel) API
      • 表格接口参数说明
      • 获取表格内容
      • 获取表格中的评论数
      • 更新表格内容
      • 追加表格内容
      • 删除表格行
      • 新增表格工作表
    • 文件-文稿文件(Word) API
      • 文稿书签说明
      • 读取文稿书签内容
      • 替换文稿书签内容
    • 文件-文档文件(类 Markdown) API
      • 获取文档中的评论列表
    • 文件-应用表格文件(多维表格)API
      • 应用表格列及单元格值结构
      • 应用表格接口调用规则
      • 获取数据表列表
      • 创建数据表
      • 获取字段列表
      • 创建字段
      • 更新字段
      • 删除字段
      • 新增行
      • 获取单行
      • 更新行
      • 删除行
    • 文件-获取额外信息 API
      • 获取文件的纯文本内容
      • 文件纯文本字数统计
      • 获取文件的历史列表
      • 获取文件的版本列表
      • 获取文件内容中所有的 @ 人信息列表
      • 还原文件历史版本
    • 系统管理 API
      • 应用管理
        • 获取应用详情
        • 更新应用回调地址
      • 用户席位管理
        • 用户席位状态说明
        • 获取用户列表和席位状态
        • 激活用户席位​
        • 取消用户席位​
        • 批量设置用户席位
    • 其他 API
      • 上报事件
      • 创建行为历史
      • 推送文件内全部的用户
      • 推送用户全部的 websocket 连接
    • 获取行列表
  • 08. 回调接口(你的应用需实现的接口)
    • 整体概述
    • 文件信息
      • 文件权限说明
      • [重要] 获取文件元信息-协同文档
      • [重要] 获取文件元信息-预览文档
      • 获取当前用户的文件列表
      • 获取文件的协作者列表
      • 获取接入方指定文件的完整访问地址
      • 获取文件元信息-协同文档自动任务(admin)
      • 根据指定用户获取文件元信息-协同文档(admin)
    • 用户信息
      • 批量获取用户信息(admin)
      • [重要] 获取当前用户信息
      • 获取当前用户所在团队信息
      • 获取指定用户信息
      • 获取用户水印信息
      • 获取用户部门路径
      • 批量获取用户信息
    • 团队和部门
      • 特殊部门 ID 说明
      • 获取团队下的成员列表
      • 获取部门信息
      • 获取部门的下级部门节点
      • 获取部门下的成员分页列表
    • 搜索功能
      • 获取与文件相关的用户列表
      • 获取与文件相关的文件列表
      • 按关键字搜索文件和用户列表
    • 事件推送
      • 整体概述
      • 评论(Comment)
        • 轻文档
          • 添加评论
          • 删除评论
          • 结束评论
          • 对于评论的回复评论
        • 表格
          • 添加评论
          • 删除评论
          • 结束评论
          • 对于评论的回复评论
        • 传统文档
          • 对于评论的回复评论
          • 添加评论
          • 更新评论
          • 删除评论
        • 幻灯片
          • 添加评论
          • 删除评论
          • 结束评论
          • 对于评论的回复评论
        • 应用表格
          • 添加评论
          • 对于评论的回复评论
          • 删除评论
      • 讨论(Discussion)
        • 轻文档
          • 发送讨论消息
      • 提及(MentionAt @ 人)
        • 轻文档
          • 在评论中 at
          • 在讨论中 at
          • 在正文中 at
        • 表格
          • 在评论中 at
          • 在正文中 at
        • 传统文档
          • 在评论中 at
          • 在正文中 at
        • 应用表格
          • 在评论中 at
          • 在正文中 at
      • 日期提醒 (DateMention)
        • 轻文档
          • 创建
          • 修改
          • 删除
        • 表格
          • 创建
          • 修改
          • 删除
        • 传统文档
          • 创建
          • 修改
          • 删除
      • 文件内容更新 (FileContent)
        • 文件内容更新
      • 文档协作者协同状态变化 (Collaborator)
        • 文档协作者协同状态变化
      • 文件版本 (Revision)
        • 版本
      • 系统事件 (System)
        • 系统事件
      • 回调请求错误(实验性)
        • 回调请求错误
  • 09. 核心模型
    • 你的应用如何设计应用(app)模型?
    • 你的应用如何设计文件数据模型?
    • 你的应用如何设计通讯录模型?
    • 你的应用系统如何设计文件权限模型?
  • 10. 典型场景方案
    • 云盘场景
    • IM 场景
    • 示例代码仓库
  • 11. 常见问题
    • 访问接口提示 Signature
    • 文件预览或导入报错
    • 首次接入 SDK 报错
    • 文档预览如何做防盗链
    • 复制粘贴、全屏操作不正常
    • 如何实现文档模板功能
    • 文档内容何时保存
    • 移动端不支持 blob 协议导致预览失败
    • 如何实现文件重命名
    • 如何通过接口修改文档内容
    • @人员时如何直接跳转至对应锚点
  1. 00. 概述

石墨文档中台支持哪些格式?

一、文件导入、导出与预览支持范围#

为了方便你在石墨中处理不同类型的办公文件,我们整理了目前支持的导入、导出与在线预览格式。你可以根据文件类型选择合适的协作方式。
如果需要通过石墨文档中台继续编辑你的文档,可以参考 文件导入支持的格式
如果需要把在石墨中台上的文档导出成其他格式,可以参考 文件导出支持的格式
如果只是想预览你的文档,可以参考 文件预览支持的格式
需要注意的是,不同石墨文件类型支持的格式会有所差异。下面分别介绍各类文件的导入、导出和预览范围,便于你在使用过程中快速查找。

二、文件导入支持的格式#

如果你希望将本地文件导入到石墨继续编辑,可以参考下表。不同类型的石墨文件,对应支持导入的源文件格式不同:
石墨文件类型支持导入的文件类型
轻文档.docx, .doc, .md, .txt
传统文档.docx, .doc, .wps
表格.xlsx, .xls, .csv, .xlsm
幻灯片.pptx, .ppt

三、文件导出支持的格式#

完成编辑后,你可以将石墨文件导出为常见办公格式,方便本地保存、打印或发送给他人。不同文件类型支持的默认导出格式和可选导出格式如下:
石墨文件类型默认导出的文件类型支持导出的文件类型
轻文档.docx.docx, .md, .jpg, .pdf
传统文档.docx.docx, .pdf, .wps
表格.xlsx.xlsx
幻灯片.pptx.pptx, .pdf
应用表格.xlsx.xlsx
如果你对文件的传播方式有要求,比如用于打印、归档或给未使用石墨的同事查看,通常可以优先选择 .pdf;如果后续还需要继续编辑,建议选择对应的 Office 格式进行导出。

四、文件预览支持的格式#

除编辑类文件外,石墨也支持对多种常见附件进行在线预览,方便在协作场景中直接查看内容,无需先下载到本地。当前支持预览的文件格式如下:
文件类型支持的扩展名格式
Office 文字.doc, .docx, .dot, .dotx, .docm, .dotm, .wps, .wpt
Office 表格.xls, .xlsx, .csv, .xlt, .xltx, .xlsm, .et, .ett
Office 幻灯片.ppt, .pptx, .pot, .potx, .pptm, .potm, .dps, .dpt
Markdown.md
文本.txt, .rtf, .log, .ini
版式文件.pdf, .ofd
图片.jpeg, .jpg, .png, .gif, .bmp, .svg, .webp, .heic, .heif, .avif
与浏览器能力有关,若浏览器不支持预览,则会导致预览失败
视频.mp4, .avi, .flv, .mpeg, .webm, .mov
与浏览器能力有关,若浏览器不支持预览,则会导致预览失败
音频.mp3, .ogg, .flac, .aac, .m4a, .wav, .oga
如果你的使用场景以查看文档为主,可以优先使用预览能力快速确认文件内容;如果需要进一步修改,则建议选择支持导入的格式,将文件转换为对应的石墨文件后再进行编辑。
修改于 2026-07-03 06:05:25
上一页
三种典型的业务接入场景
下一页
基本概念
Built with