# Document to Markdown Converter

> Document to Markdown Converter is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Converts a document at a public URL (PDF, DOCX, XLSX, PPTX, HTML, CSV, EPUB, etc.) into clean, LLM-ready markdown using Microsoft's markitdown

## Facts

- Endpoint: GET https://x402.botsmith.dev/documents/convert
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/document-to-markdown-converter-dbbb0b0c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tuu62xWCFBx5QCgQ2Xq6Y

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability document-to-markdown-converter-dbbb0b0c
```

Example prompt: Can you convert this PDF to markdown so I can work with its content? The document is at https://example.com/reports/annual-report-2024.pdf — treat it as annual-report-2024.pdf so the format is detected correctly.

## When to prefer this

Use this endpoint when you need to extract readable, structured text from a document file (PDF, Word, Excel, PowerPoint, EPUB, HTML, CSV) hosted at a public URL, especially when preparing content for LLM processing. Prefer it over a web reader for binary document formats that a normal web fetch cannot render. No API keys or accounts required — pay per call at $0.02 USDC.

## Known failure modes

- Document URL is not publicly accessible or returns a non-200 status — conversion fails
- Document exceeds 4 MB size limit — may be truncated or rejected
- Unsupported file format — markitdown cannot parse certain proprietary or encrypted formats
- URL redirects to an inaccessible resource or auth-gated page
- Malformed URL input — returns validation error
- Very large documents may be truncated (truncated=true in response)

## How this service works

Document to Markdown ($0.02/call): Convert a document at a public URL (PDF, Word/.docx, Excel/.xlsx, PowerPoint/.pptx, HTML, CSV, EPUB and more) into clean, LLM-ready markdown. Up to 4 MB. Powered by Microsoft's markitdown; no accounts or keys. The document analog of the web reader.

## Output

Returns a JSON object with: the converted document as clean markdown string, the document title (if detectable), the final source URL after redirects, the detected filename, a word count integer, and a boolean indicating if the output was truncated due to size limits (4 MB max input).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "maxLength": 2048,
       "description": "Public URL of the document to convert"
      },
      "filename": {
       "type": "string",
       "maxLength": 255,
       "description": "Filename or extension hint (e.g. report.pdf) - improves format detection"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "source",
      "filename",
      "markdown",
      "title",
      "wordCount",
      "truncated"
     ],
     "properties": {
      "title": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "source": {
       "type": "string",
       "description": "The final url converted (after redirects)"
      },
      "filename": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "markdown": {
       "type": "string",
       "description": "The document as clean markdown"
      },
      "truncated": {
       "type": "boolean",
       "description": "True if the markdown was cut to the size limit"
      },
      "wordCount": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": -9007199254740991
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/document-to-markdown-converter-dbbb0b0c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)