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 →