# Document to Markdown

> Document to Markdown is a paid MCP server for files and documents. Convert PDF, DOCX, XLSX and HTML into LLM-ready markdown with optional RAG chunks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://apify.com/catalyst-labs/document-to-markdown
- **Repository:** https://github.com/catalyst-labs-dev/catalyst-labs-mcp/tree/HEAD/servers/document-to-markdown
- **MCP Registry name:** io.github.catalyst-labs-dev/document-to-markdown
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

Built for pipelines that feed documents to models, this Apify actor detects the file type from the bytes rather than the URL and returns markdown with token counts. PDFs get page markers so answers can cite pages, and tables are rebuilt as GFM grids; DOCX and XLSX tables also survive. Chunking is optional, with each chunk carrying token count, character offsets, heading path and page.

The maker's October 2026 test on its own files reports 0.999 text F1 for one-column PDFs and 0.993 reading-order recall for two-column PDFs, compared with 0.841 for MarkItDown. Table cell placement scored 0.70, equal to Docling, though table-heavy PDFs run slower. The test used synthetic or selected files and the maker says conditions may differ.

Price is $0.001 per PDF page, other formats count one page per 3,000 characters, and failed, scanned-only or password-protected files are not charged. Up to 100 URLs or base64 files (about 9 MB) go in one call.

## Features

- **Byte-based type detection:** Identifies PDF, DOCX, XLSX, CSV and HTML from the file itself.
- **Tables as grids:** PDF tables render as GFM grids; DOCX and XLSX tables are kept.
- **RAG chunking:** Chunk size and overlap options with offsets, heading path and page.
- **Page markers:** PDFs include page comments for citations.
- **Token counts:** Reports tokens per document.
- **Per-file outcomes:** Each row states ok, no_content, blocked, encrypted or too_large.

## Good for

- Prepare PDFs for a retrieval index
- Convert a spreadsheet into markdown for a model
- Cite page numbers from a report
- Batch-convert up to 100 linked files

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http document-to-markdown 'https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown'
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "document-to-markdown": {
      "url": "https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "document-to-markdown": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "document-to-markdown": {
      "serverUrl": "https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "document-to-markdown": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown"
    }
  }
}
```

## FAQ

### What does it cost?

$0.001 per PDF page, plus a start fee per batch run.

### Are scanned PDFs supported?

Scanned-only files return NO_TEXT_LAYER and are not charged; OCR is needed.

### How is output size limited?

maxChars defaults to 50,000 per document and pages can be selected.

### How accurate is it?

The maker's own Oct 2026 tests report 0.70 table cell placement and 0.993 reading order on two-column PDFs.

### Is Document to Markdown free?

No. Document to Markdown is a paid product.

### How do I add Document to Markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http document-to-markdown 'https://mcp.apify.com/?tools=catalyst-labs/document-to-markdown'

### What are the best alternatives to Document to Markdown?

The closest alternatives to Document to Markdown are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/document-to-markdown
