Markdownify MCP Server

Developer ToolsTypeScript

Convert various file types and web content to Markdown format

Available Tools

youtube-to-markdown

Convert YouTube videos to Markdown with transcripts

pdf-to-markdown

Convert PDF files to Markdown format

bing-search-to-markdown

Convert Bing search results to Markdown

webpage-to-markdown

Convert web pages to Markdown format

image-to-markdown

Convert images to Markdown with metadata using OCR

audio-to-markdown

Convert audio files to Markdown with transcription

docx-to-markdown

Convert Word documents (DOCX) to Markdown

xlsx-to-markdown

Convert Excel spreadsheets (XLSX) to Markdown

pptx-to-markdown

Convert PowerPoint presentations (PPTX) to Markdown

get-markdown-file

Retrieve an existing Markdown file (*.md, *.markdown)

Markdownify is a powerful conversion tool that transforms a wide range of file formats and web content into clean, readable Markdown. It handles PDFs, images, audio files, web pages, Office documents, and more, making it easy to standardize content for documentation, note-taking, or content management systems. With support for YouTube transcripts, Bing search results, and general web page conversion, Markdownify serves as a comprehensive solution for content transformation. The server leverages OCR technology for images and transcription capabilities for audio, ensuring that virtually any content can be converted to the universally compatible Markdown format.

Installation

To install and run the Markdownify server, follow these steps:

Clone the repository:

git clone https://github.com/zcaceres/markdownify-mcp.git
cd markdownify-mcp

Install dependencies using pnpm (this will also install uv and related Python dependencies):

pnpm install

Build the project:

pnpm run build

Start the server:

pnpm start

Integration with Desktop Apps

To integrate Markdownify with a desktop application, add the following configuration to your app's server settings:

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "/absolute/path/to/markdownify-mcp/dist/index.js"
      ],
      "env": {
        "UV_PATH": "/path/to/uv"  // Optional: specify custom uv path
      }
    }
  }
}

Configuration Options

Markdownify supports the following environment variables for configuration:

UV_PATH: Custom path to the uv installation (optional)
MD_SHARE_DIR: Restrict the directory from which Markdown files can be retrieved (optional)

Example usage with environment variable:

MD_SHARE_DIR=/path/to/markdown/files pnpm run start

Development

For development purposes, you can use:

pnpm run dev

This starts the TypeScript compiler in watch mode, allowing you to make changes to the code and see them reflected immediately.

The main server code is in src/server.ts, and tools are defined in src/tools.ts. You can modify these files to customize the server behavior or add new conversion capabilities.