# MarkItDown Hosted Markdown Generator

## Links

- Product page URL: https://www.agentpmt.com/marketplace/markitdown
- Product markdown URL: https://www.agentpmt.com/marketplace/markitdown?format=agent-md
- Product JSON URL: https://www.agentpmt.com/marketplace/markitdown?format=agent-json

## Overview

- Product ID: 6991e8bbaa85db8efed135e4
- Vendor: Apoth3osis
- Type: function
- Unit type: request
- Price: 500 credits
- Categories: Developer Tools, Data Processing, Data Formatting & Conversion, Text Extraction & Parsing, File & Binary Operations, Document Processing & OCR
- Generated at: 2026-05-21T08:23:08.458Z

### Page Description

Turn any file into clean, readable Markdown for Agentic workflows. Accepts, PDF, Word doc, Excel spreadsheet, PowerPoint, HTML page, image, or audio file and sends back structured Markdown text — ready for analysis, indexing, or feeding into your next workflow. Uses Microsoft's official MarkItDown package for premium results that AI Agents can parse and understand.

### Agent Description

Convert files to Markdown. Supports PDF, Word (.docx), Excel (.xlsx/.xls), PowerPoint (.pptx), HTML, CSV, JSON, XML, images, audio, EPub, and ZIP archives. Provide a URL and receive the file content as Markdown text.

## Details

### Details

Turn any file into clean, readable Markdown for Agentic workflows. Accepts, PDF, Word doc, Excel spreadsheet, PowerPoint, HTML page, image, or audio file and sends back structured Markdown text — ready for analysis, indexing, or feeding into your next workflow. Uses Microsoft's official MarkItDown package for premium results that AI Agents can parse and understand.

### Actions

- `convert` (5 credits): Convert a file to Markdown. Provide the file using exactly one of: url, file_id, or file_base64. Supports PDF, Word, Excel, PowerPoint, HTML, CSV, JSON, XML, images, audio, EPub, and ZIP. Max 50MB.

### Use Cases

Convert PDF documents to Markdown, Extract text from Word documents, Convert Excel spreadsheets to readable Markdown, Parse PowerPoint presentations into text, Convert HTML pages to Markdown, Extract content from EPub files, Process ZIP archives of documents

### Workflows Using This Tool

#### AI Contract Redline: Compare Signed Documents Against Originals

Automatically redline any signed contract or agreement against its original and produce an exhaustive change report before counter-signing. Upload the returned signed document (PDF, DOCX, or scanned image), name the original stored in Google Drive (DOCX or native Google Doc), and the workflow OCRs the signed copy, locates and downloads the original from Drive, converts both to clean text, and surfaces every difference categorized by type: substantive wording and clause changes with section numbers and side-by-side quotes, filled-in fields such as parties, effective dates, dollar amounts, addresses, and signer names and titles, signature block label differences, DocuSign and other e-signature artifacts, OCR rendering artifacts to ignore, and shared typos worth fixing in the original. Built for legal contract review, NDA comparison, MSA and SOW intake, vendor agreement onboarding, employment offer letter audits, partnership and referral agreement review, sales contract redlining, real estate purchase agreement comparison, insurance policy diff, lease and rental agreement review, and any returned-document intake workflow where you need to know exactly what changed before filing or counter-signing. Eliminates manual side-by-side reading, accelerates legal and operations review cycles, and prevents accidental acceptance of unfavorable revisions hidden inside a returned signed document.

- Page URL: https://www.agentpmt.com/agent-workflow-skills/ai-contract-redline-compare-signed-documents-against-originals--69ec0559fafea730edcbc179
- Markdown URL: https://www.agentpmt.com/agent-workflow-skills/ai-contract-redline-compare-signed-documents-against-originals--69ec0559fafea730edcbc179?format=agent-md
- Published: 2026-04-25T00:38:15.240Z

### Related Content

No related content is currently linked to this product.

## Integration Details

### DynamicMCP

- Setup page URL: https://www.agentpmt.com/dynamic-mcp
- Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos
- ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos
- Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos
- Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer.

```bash
npm install -g @agentpmt/mcp-router
agentpmt-setup
```

### REST API

The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials.

- Purchase endpoint: https://api.agentpmt.com/products/purchase
- Authorization format: `Bearer <base64(apiKey:budgetKey)>`

```bash
curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \
  -d '{
    "product_id": "6991e8bbaa85db8efed135e4",
    "parameters": {
      "action": "convert"
    }
  }'
```

### Autonomous Agents

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### Schema

#### Parameters

- Schema type: actions

```json
{
  "actions": {
    "convert": {
      "description": "Convert a file to Markdown. Provide the file using exactly one of: url, file_id, or file_base64. Supports PDF, Word, Excel, PowerPoint, HTML, CSV, JSON, XML, images, audio, EPub, and ZIP. Max 50MB.",
      "properties": {
        "url": {
          "type": "string",
          "description": "Public URL or signed storage URL of the file to convert",
          "required": false
        },
        "file_id": {
          "type": "string",
          "description": "File ID from the file upload tool",
          "required": false
        },
        "file_base64": {
          "type": "string",
          "description": "Base64-encoded file content",
          "required": false
        },
        "filename": {
          "type": "string",
          "description": "Original filename with extension (helps detect format when using file_base64)",
          "required": false
        }
      }
    }
  },
  "properties": {
    "action": {
      "type": "string",
      "description": "Action to perform",
      "required": true,
      "default": "get_instructions",
      "enum": [
        "get_instructions",
        "convert"
      ]
    },
    "url": {
      "type": "string",
      "description": "Public URL or signed storage URL of the file to convert",
      "required": false
    },
    "file_id": {
      "type": "string",
      "description": "File ID from the file upload tool",
      "required": false
    },
    "file_base64": {
      "type": "string",
      "description": "Base64-encoded file content",
      "required": false
    },
    "filename": {
      "type": "string",
      "description": "Original filename (helps detect format when using file_base64)",
      "required": false
    }
  }
}
```

### Usage Instructions

# MarkItDown

Convert files and URLs to Markdown using Microsoft's MarkItDown library. Supports PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), HTML, CSV, JSON, XML, images (PNG, JPG), audio (MP3, WAV -- transcription), EPub, ZIP archives, and plain text. Maximum file size: 50 MB.

## Actions

### convert

Convert a file to Markdown. Provide the file using exactly ONE of three input methods.

**Required Parameters (one of):**
- `url` (string) -- Public URL or signed storage URL of the file to convert. The tool follows redirects and detects file format from the URL path or Content-Type header.
- `file_id` (string) -- File ID from the AgentPMT file upload tool. The tool retrieves the file from cloud storage and uses the stored original filename to detect format.
- `file_base64` (string) -- Base64-encoded file content for direct inline submission.

**Optional Parameters:**
- `filename` (string) -- Original filename including extension (e.g., "report.pdf"). Helps detect the correct format when using `file_base64`. Also useful when the URL or file_id does not clearly indicate the file type.

**Response Fields:**
- `action` (string) -- Always "convert"
- `source` (string) -- Input method used: "url", "file_id", or "file_base64"
- `markdown` (string) -- The converted Markdown text content
- `length` (integer) -- Character count of the Markdown output

**Example -- Convert from URL:**
```json
{
  "action": "convert",
  "url": "https://example.com/report.pdf"
}
```

**Example -- Convert from file upload:**
```json
{
  "action": "convert",
  "file_id": "abc123-def456"
}
```

**Example -- Convert from base64 with filename hint:**
```json
{
  "action": "convert",
  "file_base64": "JVBERi0xLjQK...",
  "filename": "quarterly_report.pdf"
}
```

**Example Response:**
```json
{
  "action": "convert",
  "source": "url",
  "markdown": "# Report Title\n\nSection content here...",
  "length": 4521
}
```

## Workflows

1. **Document analysis pipeline** -- Upload a file using the file upload tool, then pass the returned `file_id` to MarkItDown to convert it to Markdown for further processing or summarization by an AI agent.
2. **Web page to Markdown** -- Provide a public URL of an HTML page to extract its content as clean Markdown, useful for archiving or content repurposing.
3. **Spreadsheet data extraction** -- Convert Excel or CSV files to Markdown tables for readable display or further data analysis.
4. **Presentation content extraction** -- Convert PowerPoint files to Markdown to extract slide content, speaker notes, and structure for review or repurposing.
5. **Archive inspection** -- Convert a ZIP file to get a Markdown listing/extraction of its contents.

## Notes

- Exactly one input method must be provided per request (`url`, `file_id`, or `file_base64`). Providing none will result in a validation error.
- The maximum file size is 50 MB regardless of input method. Files exceeding this limit are rejected.
- When using `file_base64`, providing `filename` with the correct extension significantly improves format detection accuracy.
- When using `url`, the tool auto-detects format from the URL file extension first, then falls back to the HTTP Content-Type header.
- For `file_id` input, the file must not be deleted or expired, and must belong to the same budget context.
- Audio files (MP3, WAV) are transcribed to text and returned as Markdown.
- Image files are processed for any text content (OCR-style extraction via MarkItDown).
- If format cannot be determined, the file is treated as a binary file with extension `.bin`.
- The conversion runs asynchronously on the server; large files may take longer to process.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

These products are automatically added when this product is enabled on the page UI.

#### File Management

Upload, list, retrieve, share, download, delete, and manage files stored in AgentPMT cloud storage. This product now owns the full file lifecycle, including signed upload URLs for files up to 10MB and for files over 10MB up to 100MB, budget-scoped file listing with preview URLs, fresh signed download URLs, direct base64 download for smaller files, password-protected sharing, metadata and tag updates, access-history inspection, and expiration extension. All file operations are scoped to the current budget for isolation and are designed to let one budget create persistent files that can be revisited across later agent runs.

- Page URL: https://www.agentpmt.com/marketplace/file-management
- Markdown URL: https://www.agentpmt.com/marketplace/file-management?format=agent-md