markdown-new-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@markdown-new-mcp Convert this PDF to markdown: https://example.com/report.pdf"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
markdown-new-mcp
MCP (Model Context Protocol) server for markdown.new file conversion API. Convert PDF, DOCX, XLSX, images and 20+ formats to Markdown.
Installation
npm install markdown-new-mcpRelated MCP server: MarkItDown MCP
Usage
With Claude Desktop or Claude Code
For stdio MCP clients, use npx -y so the server starts under Node.js and preserves the JSON-RPC stdio stream. Add this to your Claude config:
{
"mcpServers": {
"markdown-new": {
"command": "npx",
"args": ["-y", "markdown-new-mcp@latest"]
}
}
}With opencode
Add this to the mcp section of ~/.config/opencode/opencode.json:
{
"mcp": {
"markdown-new": {
"type": "local",
"command": ["npx", "-y", "markdown-new-mcp@latest"]
}
}
}With API Key (Optional)
For higher rate limits, you can provide an API key via environment variable:
{
"mcpServers": {
"markdown-new": {
"command": "npx",
"args": ["-y", "markdown-new-mcp@latest"],
"env": {
"MARKDOWN_NEW_API_KEY": "mk_your_api_key_here"
}
}
}
}Optional:
MARKDOWN_NEW_TIMEOUT_MS: request timeout in milliseconds for upstream API calls (default:30000)
Available Tools
convert_url_to_markdown
Convert a remote file URL to clean Markdown text. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Parameters:
url(string, required): HTTP or HTTPS URL of the remote fileapi_key(string, optional): API key for higher rate limits; the server also readsMARKDOWN_NEW_API_KEY
Example:
Convert this PDF to markdown: https://example.com/document.pdfconvert_file_to_markdown
Convert a local file to clean Markdown text. The path must be absolute and visible to the server process. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Parameters:
file_path(string, required): The absolute path to the local fileapi_key(string, optional): API key for higher rate limits; the server also readsMARKDOWN_NEW_API_KEY
Example:
Convert /path/to/document.pdf to markdownconvert_url_to_json
Convert a remote file URL to structured JSON, including metadata such as title, tokens, and duration. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Parameters:
url(string, required): The URL of the remote fileapi_key(string, optional): API key for higher rate limits; the server also readsMARKDOWN_NEW_API_KEY
Supported Formats
Documents: PDF, DOCX, ODT
Spreadsheets: XLSX, XLS, XLSM, XLSB, ET, ODS, Numbers
Images: JPG, JPEG, PNG, WebP, SVG
Text/Data: TXT, MD, CSV, JSON, XML, HTML, HTM
Limits
Without API Key: 500 requests/day per IP
With API Key: Higher limits available
Maximum File Size: 10MB
Development
# Install dependencies
npm install
# Build
npm run build
# Run locally
npm run dev
# Smoke test the stdio MCP server
npm run build
npm run smoke:stdio -- node dist/index.jsLicense
MIT
Available Tools
3 toolsconvert_file_to_markdownARead-only
Convert a local file to clean Markdown text. The path must be absolute and visible to the server process. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Inputs: file_path (required), api_key.
convert_url_to_jsonBRead-only
Convert a remote file URL to structured JSON, including metadata such as title, tokens, and duration. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Inputs: url (required), api_key.
convert_url_to_markdownARead-only
Convert a remote file URL to clean Markdown text. Supports PDF, DOCX, XLSX, images, and 20+ formats.
Inputs: url (required), api_key.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct combination of input source (URL vs local file) and output format (Markdown vs JSON), and the descriptions clearly state these differences, leaving no ambiguity in selection.
All three tools follow the identical pattern convert_{source}_to_{format}, using snake_case consistently and predictable verb-noun structure throughout.
Three tools is well-scoped for a focused file-conversion server, covering the primary source-output combinations without unnecessary bloat or glaring thinness.
The surface covers URL→Markdown, file→Markdown, and URL→JSON, but omits file→JSON conversion, which is an obvious companion operation given the existing URL→JSON tool. This gap may force workarounds for local files needing structured output.
Maintenance
Related MCP Connectors
Convert PDF, DOCX, XLSX and 25 other formats to clean Markdown for LLMs and RAG. No key or account.
Converts PDF, scans, DOCX, XLSX and PPTX to Markdown with tables and page-aware RAG chunks.
Convert PDF, Word, Excel and scanned documents to Markdown, tables and RAG chunks. OCR.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceConverts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.10681 npm3,004MIT
- AlicenseNot gradedqualityDmaintenanceConverts various file types (documents, images, audio, web content) to markdown format without requiring Docker, supporting PDF, Word, Excel, PowerPoint, images, audio files, web URLs, and more.397 npm14MIT
- AlicenseAqualityDmaintenanceConverts various file types (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube videos, web pages, Bing search results) into Markdown format for easy reading and sharing.10MIT
- AlicenseNot gradedqualityDmaintenanceConverts PDF, Word, and Excel documents to Markdown with image extraction and header/footer removal via MCP or REST API.52MIT