Markdownify MCP Server
The Markdownify MCP Server is a tool for converting various file types and web content into Markdown format.
Convert file types to Markdown: PDFs, images, audio (with transcription), DOCX, XLSX, PPTX
Convert web content to Markdown: YouTube video transcripts, Bing search results, general web pages
Retrieve existing Markdown files: Get Markdown files by absolute path, optionally restricting access to a specific directory
Integration: Can be integrated with desktop apps through server configuration
Converts various file types and web content to Markdown format
Uses Python dependencies through 'uv' for file conversion capabilities
Server is built with TypeScript, allowing customization of server behavior
Converts YouTube videos to Markdown with transcripts
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., "@Markdownify MCP Server convert this PDF to markdown"
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.
Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts 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.
Features
Convert multiple file types to Markdown:
PDF
Images
Audio (with transcription)
DOCX
XLSX
PPTX
Convert web content to Markdown:
YouTube video transcripts
Bing search results
General web pages
Retrieve existing Markdown files
Related MCP server: Markdownify MCP Server
Getting Started
Clone this repository
Install dependencies:
bun installThe
preinstallstep creates a Python virtual environment at.venvand installsmarkitdown[all].Build the project:
bun run buildStart the server:
bun start
Development
Use
bun run devto start the TypeScript compiler in watch modeModify
src/server.tsto customize server behaviorAdd or modify tools in
src/tools.ts
Usage with Desktop App
To integrate this server with a desktop app, add the following to your app's server configuration:
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
]
}
}
}Environment variables
All paths default to sensible values; override only when the defaults don't fit your install layout.
Variable | Default | Purpose |
|
| Absolute path to the |
|
| Absolute path to the |
| unset (unrestricted) | Path-delimiter-separated list ( |
| unset | Deprecated alias for |
Usage with Docker
Build and run:
docker build -t markdownify-mcp .
docker run --rm -i \
-v "$HOME/Documents:/data:ro" \
-e MD_ALLOWED_PATHS=/data \
markdownify-mcpNotes for the Docker MCP catalog (mcp/markdownify):
Mount any host directories you want the server to read into the container, then pass the container paths to the tools (e.g.
/data/foo.pdf, not/Users/you/Documents/foo.pdf).Set
MD_ALLOWED_PATHSto the colon-separated list of mounted directories so the server enforces a read boundary that matches the bind mount.The published Docker image installs
markitdown[pdf]only — audio transcription and image OCR (audio-to-markdown,image-to-markdown) require the[all]extras and will fail in the slim image. Use the local install (bun install) for the full feature set.
Available Tools
youtube-to-markdown: Convert YouTube videos to Markdownpdf-to-markdown: Convert PDF files to Markdownbing-search-to-markdown: Convert Bing search results to Markdownwebpage-to-markdown: Convert web pages to Markdownimage-to-markdown: Convert images to Markdown with metadataaudio-to-markdown: Convert audio files to Markdown with transcriptiondocx-to-markdown: Convert DOCX files to Markdownxlsx-to-markdown: Convert XLSX files to Markdownpptx-to-markdown: Convert PPTX files to Markdownget-markdown-file: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.OPTIONAL: set
MD_ALLOWED_PATHSto restrict every file-input tool to a list of directories, e.g.MD_ALLOWED_PATHS=/data/in:/data/out bun start.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
10 toolsaudio-to-markdownC
Convert an audio file to markdown, including transcription if possible
Inputs: filepath (required).
bing-search-to-markdownC
Convert a Bing search results page to markdown
Inputs: url (required).
docx-to-markdownC
Convert a DOCX file to markdown
Inputs: filepath (required).
get-markdown-fileC
Get a markdown file by absolute file path
Inputs: filepath (required).
image-to-markdownC
Convert an image to markdown, including metadata and description
Inputs: filepath (required).
pdf-to-markdownC
Convert a PDF file to markdown
Inputs: filepath (required).
pptx-to-markdownC
Convert a PPTX file to markdown
Inputs: filepath (required).
webpage-to-markdownC
Convert a webpage to markdown
Inputs: url (required).
xlsx-to-markdownC
Convert an XLSX file to markdown
Inputs: filepath (required).
youtube-to-markdownC
Convert a YouTube video to markdown, including transcript if available
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose focused on converting a specific input format (audio, Bing search, DOCX, etc.) to markdown. The descriptions specify unique source types, making it impossible to confuse which tool to use for a given conversion task.
All tools follow a consistent pattern of 'source-to-markdown' (e.g., audio-to-markdown, docx-to-markdown). This uniform naming convention makes it easy to predict tool names and understand their functions at a glance.
With 10 tools, the server covers a comprehensive range of common input formats (audio, documents, web content, spreadsheets, presentations, etc.) for markdown conversion. This count is well-scoped for the domain, providing thorough coverage without being overwhelming.
The tool set offers complete coverage for converting various media and file types to markdown, including audio, images, documents, webpages, and videos. There are no obvious gaps; each tool handles a distinct input format, ensuring agents can convert any supported source without dead ends.
Maintenance
Related MCP Connectors
Convert PDF, Word, Excel, PowerPoint, e-mails and web pages to clean Markdown for LLMs.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Documents to Markdown/PDF, OCR, video and audio transcripts, TTS, screenshots, domains, frames.
Related MCP Servers
- 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 documents, webpages, and media files into markdown for AI assistants using Microsoft's MarkItDown and Crawl4AI. It enables tools to read PDFs, Office files, and JavaScript-rendered websites with support for OCR and image extraction.3MIT
- AlicenseNot gradedqualityDmaintenanceConverts files (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube transcripts, Bing search, general pages) to Markdown via the Model Context Protocol.Apache 2.0