- Markdown适合知识库迁移、Git归档、全文检索和长期备份
- 图片是否保留，关键看导出时是否同步下载资源并改写相对路径
- 复杂表格、批注、嵌入组件不适合只用Markdown保存，建议同步导出PDF或Word
- 批量导出时要保留文件夹层级，避免同名文档覆盖
- 导出完成后至少抽查图片、表格、链接、附件和文件名编码五项
石墨文档导出Markdown适合把在线文档转成可编辑、可检索、可版本管理的本地资料。推荐流程是：先按文件夹批量导出为Markdown，再同步下载图片资源，最后抽查图片路径、表格结构、内部链接和文件名。对于合同、公告、排版复杂的文档，不建议只保留Markdown，应同时导出PDF作为定稿归档。
很多人第一次导出Markdown时，只盯着正文有没有出来，忽略了图片、表格和链接。结果真正迁移到新平台或放进Git仓库后，才发现图片全是线上链接，表格被压扁，内部链接跳不回原文档。
这篇文章只讲一个具体问题：如何把石墨文档导出成一份可长期保存的Markdown归档。它和 石墨文档导出完全指南 的关系是：完全指南解决所有格式和所有场景，这篇专门解决Markdown格式的细节。
如果你还不确定该导出哪种格式，先看这篇对比。
什么时候应该导出Markdown？
当你的目标是迁移、二次编辑、全文检索或版本管理时，Markdown通常是首选格式。它是纯文本，打开门槛低，不绑定某一个办公软件，也适合被Git、知识库和AI检索系统读取。
| 使用场景 | 是否推荐Markdown | 原因 |
|---|---|---|
| 知识库迁移 | 推荐 | 大多数知识库和笔记工具都能导入Markdown |
| Git版本管理 | 推荐 | 纯文本便于diff、回滚和协作审阅 |
| 合同、报价单、盖章文件 | 不单独推荐 | 需要固定版式，建议导出PDF或Word |
| 复杂表格和嵌入组件 | 谨慎 | Markdown对复杂排版表达能力有限 |
推荐的5步导出流程
第1步：先整理文件夹和文件名
导出前先处理两个问题：重复标题和特殊字符。重复标题容易在本地生成同名文件，特殊字符可能在不同系统之间产生兼容问题。建议把核心资料按项目、部门或时间归入固定文件夹，再开始批量导出。
第2步：优先按文件夹批量导出
如果文档数量超过50份，逐个打开导出很容易漏文件。批量导出时，最重要的是保留石墨里的目录层级，让本地归档能对应原始团队空间或个人空间。
不想逐个导出时，可以参考这篇安装和批量导出流程。
第3步：确认图片资源已本地化
一份可长期保存的Markdown，不应该只依赖线上图片链接。导出后请检查md文件附近是否有图片资源目录，并打开几篇含图文档，确认图片能在断网情况下显示。
随机抽查3类文档：含截图的教程、含流程图的方案、含多张图片的周报。只要其中一类图片不能显示，就不要急着删除云端原文档。
第4步：检查表格和链接
Markdown表格适合简单二维表，但不擅长合并单元格、复杂样式和嵌套内容。对于重要表格，建议同时导出Excel或Word。链接则要重点检查内部链接、附件链接和外部URL，避免迁移后跳回需要登录的旧平台。
第5步：建立归档校验清单
导出完成后，不要只看文件数量。更可靠的做法是建立一张校验清单，记录导出时间、导出账号、文件总数、失败文件、抽查结果和备份位置。团队场景下，这张清单比单次导出动作更重要。
Markdown导出的限制
Markdown不是万能格式。它的优点是通用、轻量、可迁移，缺点是对复杂视觉排版支持有限。下面这些内容要特别小心：
- 合并单元格、复杂表格样式可能被简化
- 评论、批注、历史版本通常不会进入Markdown正文
- 嵌入式附件、第三方组件、投票表单可能只留下链接
- 页面宽度、字体、颜色等视觉细节不会完全保留
- 跨文档引用需要导出后重新校验路径
如果资料涉及合同、财务、审批、客户交付，建议至少保留Markdown和PDF两份。Markdown用于检索和迁移，PDF用于定稿和审计。
批量导出Markdown的命名建议
批量导出时，文件名最好稳定、可排序、可搜索。推荐使用以下规则：
- 项目资料：项目名-文档主题-版本号
- 会议纪要：日期-团队-会议主题
- 知识库文章：一级分类/二级分类/文章标题
- 归档目录：导出日期-空间名称-导出格式
如果未来要把Markdown放进Git仓库，建议在根目录增加一份README，说明导出来源、导出时间和目录规则。AI检索、团队交接和二次迁移都会更容易。
导出只是第一步，迁移后的校验、归档和备份同样重要。
常见问题
石墨文档导出Markdown时图片会丢吗？
如果导出过程只保存正文而没有同步下载图片资源，图片就可能变成线上链接，未来账号失效或权限变化后无法访问。推荐使用能同步资源目录的导出方式，并在导出后断网抽查。
Markdown适合长期归档石墨文档吗？
适合，但它更适合作为可编辑和可检索版本。对需要固定版式和法律留痕的资料，建议同时导出PDF。对需要继续编辑复杂排版的资料，建议同步导出Word。
石墨文档批量导出Markdown能保留文件夹结构吗？
可以，但前提是导出工具支持按空间或文件夹层级下载。导出后应检查本地目录是否和石墨中的结构一致，尤其是团队空间下的多级文件夹。
Markdown导出后可以导入飞书、语雀或Notion吗？
通常可以，但每个平台对Markdown扩展语法、图片资源和表格的处理方式不同。迁移前建议先选10份典型文档试导入，确认图片、链接和表格效果，再批量处理。
