语雀如何导出文档为Markdown：四种实践方案

在语雀上完成文档创作后，若需迁移至其他平台或进行版本管理，将其转换为Markdown格式是高效的选择。

从官方一键导出到技术流的API调用，有多种方法可供选择。下面将详细拆解四种主流方案。

一、使用语雀网页版“导出为Markdown”功能

对大多数用户而言，最直接省心的方法是使用语雀官方提供的导出功能。它能很好地处理标准文档结构。

操作步骤如下：

• 登录语雀官网，打开需要转换的文档。
• 点击页面右上角的更多操作按钮（通常是三个点图标）。
• 在下拉菜单中，选择“导出为 Markdown”选项。
• 浏览器将自动下载一个以文档标题命名的.md文件。

此方法能完整保留文档中的文本、标题层级、列表及内联代码块。

二、通过语雀API批量获取Markdown内容

如需批量处理文档，或希望将导出流程自动化、集成到工具链中，调用语雀开放API是更专业的选择。该方法尤其受开发者或运维人员青睐。

核心流程如下：

• 前往语雀开发者中心，申请个人访问令牌（Personal Access Token）。
• 使用curl或Postman等工具，向接口发起GET请求：https://www.yuque.com/api/v2/docs/{slug}。
• 在请求头中携带令牌：Authorization: Bearer {token}。
• 接口返回JSON格式数据，其中的body字段值即为标准Markdown格式字符串。

三、利用第三方脚本提取并转换HTML为Markdown

当文档包含复杂元素，官方导出功能可能力有不逮时，可转换思路：先获取文档渲染后的HTML，再用工具将其转为Markdown。此方法兼容性较好。

具体分为四步：

• 第一步：在文档页面按下Ctrl+U（Windows）或Cmd+Option+U（Mac），打开网页源代码。
• 第二步：从源码中找到包含文档主体的HTML片段（通常在“yuque-article”容器内）。
• 第三步：使用Python的html2text库执行转换命令。
• 第四步：将输出结果保存为.md文件，并检查标题缩进和链接是否正确还原。

四、使用浏览器扩展辅助导出

若不熟悉命令行操作，又需频繁导出文档，借助浏览器扩展是完美的折中方案。它能实现近乎“一键转换”的便捷。

以MarkDownload扩展为例：

• 在Chrome或Edge浏览器商店中安装此扩展。
• 打开语雀文档，点击地址栏右侧的MarkDownload图标。
• 在弹出的面板中，建议勾选“仅正文区域”，然后点击“下载Markdown”。

扩展生成的文件会保留图片的相对路径。若文档包含外链图片，下载后建议手动校验URL有效性。

《夸克》非常好用的免费AI浏览器

下载APP查看