语雀支持四种外部文档导入方式：一、网页端“从文件导入”markdown或word；二、桌面客户端拖入文件夹自动同步；三、调用api编程导入；四、复制粘贴后手动格式化。
如果您希望将本地或其他平台的文档内容迁移到语雀，但不确定具体操作流程，则可能是由于不熟悉语雀支持的导入格式与入口位置。以下是完成外部文档导入的多种可行方式：
一、通过网页端“新建文档”上传 Markdown 或 Word 文件
语雀网页端支持直接上传常见文本类文档，系统会自动解析并转换为语雀原生格式，保留基础排版结构。适用于已编辑完成的 .md 或 .docx 文件。
1、登录语雀官网，进入目标知识库页面。
2、点击右上角“新建文档”按钮旁的下拉箭头，选择“从文件导入”。
3、在弹出窗口中拖入或点击选择本地的 Markdown（.md）或 Word（.docx）文件。
4、等待解析完成，确认标题与段落无误后点击“导入”。
二、使用语雀桌面客户端批量拖拽导入
语雀桌面客户端（Windows/macOS）提供更稳定的文件监听与批量处理能力，尤其适合一次导入多个文档或含图片的 Word 文件。
1、下载并安装最新版语雀桌面客户端，使用账号登录。
2、在左侧知识库列表中，右键点击目标知识库，选择“在资源管理器中打开”（Windows）或“在访达中显示”（macOS）。
3、将待导入的 .md、.docx、.txt 文件直接拖入该文件夹。
4、客户端自动识别并同步生成文档，状态栏显示“同步完成”即表示导入成功。
三、通过语雀 API 导入结构化内容
对于需自动化处理或对接其他系统的场景，可调用语雀开放 API 将 HTML 或 Markdown 内容以 POST 方式写入指定知识库，适用于开发人员或 IT 运维人员。
1、前往语雀开发者中心申请个人访问令牌（Personal Access Token），勾选 doc.write 权限。
2、构造 HTTP POST 请求，请求头包含 Authorization: Bearer {token}，Body 为 JSON 格式，含 spaceId、title、format（支持 markdown/html）、content 字段。
3、发送请求后检查返回状态码，200 表示文档创建成功，返回新文档的 uuid。
四、复制粘贴富文本内容并手动格式化
当外部文档来源为网页、Notion、飞书等不支持直导出的平台时，可借助浏览器复制其渲染后的可视内容，在语雀中粘贴并重建层级关系。
1、在源平台中选中正文区域（避开导航栏与侧边栏），按 Ctrl+C（Windows）或 Cmd+C（macOS）复制。
2、在语雀新建文档编辑区，先粘贴一次，再全选粘贴内容，点击工具栏中的“清除格式”按钮。
3、逐段应用语雀标题样式：一级标题用 # + 空格，二级标题用 ## + 空格，列表项前加 - 或 1.。
