语雀支持四种本地文档导入方式：一、网页端拖拽上传，适用于少量常见格式文件；二、桌面客户端批量导入，适合多级标题与图片文档；三、word转markdown后粘贴导入，保障复杂样式完整性；四、api脚本自动化导入，面向技术用户实现定期同步。
如果您希望将本地编写的文档添加到语雀知识库中，需要通过语雀客户端或网页端提供的导入功能完成。以下是实现本地文档导入的多种方法：
一、通过语雀网页端直接拖拽上传
该方式适用于单个或少量文档的快速导入，支持常见格式如 Markdown、Word（.docx）、PDF 和纯文本文件。语雀会自动解析内容结构并保留基础格式。
1、登录语雀官网并进入目标知识库页面。
2、在知识库左侧目录区空白处，将本地文档文件直接拖入页面指定区域。
3、等待上传进度条完成，系统自动生成对应文档卡片。
4、点击新生成的文档标题，确认内容是否正确渲染，必要时手动调整标题或目录层级。
二、使用语雀桌面客户端批量导入
语雀桌面客户端支持离线编辑与批量导入，尤其适合含多级标题、图片嵌入或需保持原始排版的文档集合。导入后可同步至云端知识库。
1、下载并安装最新版语雀桌面客户端（Windows/macOS）。
2、启动客户端并登录同一账号，确保已加入目标知识库。
3、在客户端左上角点击“+ 新建文档”，选择“从本地文件导入”选项。
4、在弹出窗口中，按住 Ctrl（Windows）或 Command（macOS）键多选多个文档，点击“打开”。
5、为每份文档指定父级目录与排序位置，点击“确认导入”。
三、将 Word 文档转换为 Markdown 后粘贴导入
当原始 Word 文件含有复杂样式（如多栏、页眉页脚、嵌入对象）导致自动解析失真时，可先转为标准 Markdown 格式再人工校验后导入，以保障内容完整性。
1、使用 Pandoc 或 Typora 等工具将 .docx 文件导出为 .md 文件。
2、用文本编辑器打开生成的 Markdown 文件，检查标题层级、列表缩进及图片路径是否正常。
3、在语雀网页端新建文档，切换至“源码模式”（右上角三个点 → 源码模式）。
4、全选并粘贴 Markdown 内容，关闭源码模式后查看实时渲染效果。
四、通过 API 脚本自动化导入（面向技术用户）
适用于需定期同步大量本地文档至语雀的场景，利用语雀开放 API 实现文档创建与内容写入，支持自定义元数据和权限设置。
1、前往语雀开发者中心申请个人访问令牌（Personal Access Token），勾选 documents:write 权限。
2、准备一个包含文档路径、知识库 ID、目标目录 ID 的 JSON 配置文件。
3、运行 Python 脚本调用 POST /v2/repos/{repo_id}/docs 接口，请求体中传入 title 和 content 字段。
4、每次请求仅支持单文档提交，批量处理需循环执行并控制请求频率。
