API Documentation

inktomd API

Free REST API to convert any file or URL to clean Markdown. No API key required.

Overview

inktomd provides a free public REST API for converting files and URLs to clean Markdown. No authentication required. Rate limited to 50 requests per hour per IP.

Base URL

https://www.inktomd.com/api

Endpoints

POST/convert

Convert a file to Markdown.

Request (multipart/form-data):

  • file: [binary file data]

Response:

{
  "markdown": "# Document Title\n\nContent here..."
}

Example (curl):

curl -X POST https://www.inktomd.com/api/convert \
  -F "[email protected]"

Example (Python):

import requests

with open("document.pdf", "rb") as f:
    response = requests.post(
        "https://www.inktomd.com/api/convert",
        files={"file": f}
    )
    
markdown = response.json()["markdown"]
print(markdown)

Example (JavaScript):

const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch('https://www.inktomd.com/api/convert', {
  method: 'POST',
  body: formData
});

const { markdown } = await response.json();

POST/convert-url

Convert a URL to Markdown.

Request (application/json):

{
  "url": "https://example.com/article"
}

Response:

{
  "markdown": "# Article Title\n\nContent here..."
}

Example (curl):

curl -X POST https://www.inktomd.com/api/convert-url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://en.wikipedia.org/wiki/Markdown"}'

GET/health

Check API status.

Response:

{
  "status": "ok"
}

Supported Formats

The API supports all 24 formats available on our web interface, including PDF, DOCX, XLSX, PPTX, HTML, EPUB, standard URLs, YouTube URLs, and ArXiv URLs.

See all 24 formats on our homepage →

Rate Limits & Restrictions

  • 50 requests per hour per IP address
  • Maximum file size: 20MB
  • No authentication required

Error Responses:

// 400 Bad Request
{"detail": "Unsupported file format"}

// 413 Request Too Large  
{"detail": "File too large. Maximum size is 20MB."}

// 429 Too Many Requests
{"detail": "Rate limit exceeded. Try again later."}

// 500 Internal Server Error
{"detail": "Conversion failed"}

MCP Server

Prefer using inktomd from your AI agent? Check out the inktomd MCP server for Claude Code and Cursor.

View MCP Server Docs →