Markdown 输出

通过在负载中设置 "markdown": true，从 Oxylabs 网页爬虫API 请求 Markdown 格式输出——适用于 AI 工作流和轻量内容。

此功能允许您将网页的 markdown 表示形式作为 HTML 或解析后的 JSON 之外的另一种可选方式接收。markdown 输出提供易于阅读的格式，简化了集成到各种内容工作流中。

Markdown 格式在与 LLMs 配合使用时尤其有用，因为它轻量且语法清晰。它是 RAG（检索增强生成）用例的事实标准，尤其是在涉及网页数据摄取时。

用法

要在响应中获取网页的 markdown 内容，请在 "markdown": true 放入您的请求有效载荷中。默认情况下，此参数设置为 false。设置后，markdown 将成为任务的默认输出，并替换响应中的 HTML；若要同时接收两者，请如下方第二个示例所示显式请求。

请求示例

下面是提交 markdown 输出请求的方法：

POST https://data.oxylabs.io/v1/queries

{
    "url": "https://example.com",
    "markdown": true
}

您还可以在 ?type=raw,markdown Real-Time API 端点 URL 中添加，以同时获取 markdown 和原始 HTML 结果。

POST https://realtime.oxylabs.io/v1/queries?type=raw,markdown

{
    "url": "https://example.com",
    "markdown": true
}

响应示例

响应将包含以 markdown 格式呈现的网页内容，作为字符串返回。该字符串将包括用于标题、段落、列表、链接、图片以及页面中其他结构化元素的标准 markdown 语法。

{
    "results": [
        {
            "content": "# 示例域名\n\n此域名用于文档示例，无需许可。请勿用于实际操作。\n\n[了解更多](https://iana.org/domains/example)",
            "created_at": "2026-09-14 11:22:13",
            "updated_at": "2026-09-14 11:22:14",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7505224385041566721",
            "status_code": 200,
            "type": "markdown"
        }
    ],
    "job": {...}
}