What is Markdownify

Markdownify-MCP is a Model Context Protocol server designed to convert various file types and web content into Markdown format. It serves as a tool for transforming PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.

Use cases

Markdownify-MCP can be utilized for converting multiple file types, such as documents (PDF, DOCX, XLSX, PPTX), media files (images, audio), and web content (YouTube transcripts, Bing search results, general web pages) into Markdown format. This aids in streamlining content creation and sharing for various applications.

How to use

To start using Markdownify-MCP, clone the repository, install dependencies using ‘pnpm install’, build the project using ‘pnpm run build’, and start the server with ‘pnpm start’. For integration with a desktop app, configure the server parameters in the app’s configuration file.

Key features

Key features include support for multiple file type conversions such as PDF, DOCX, XLSX, and audio transcription, as well as the ability to retrieve existing Markdown files. It also offers specific tools for converting web content, including YouTube videos and Bing search results, into Markdown.

Where to use

Markdownify-MCP can be used in various contexts including application development, content management systems, and desktop applications where there is a need to transform and utilize Markdown formatted text for better readability and shareability.

Markdownify MCP Server

Help! I need someone with a Windows computer to help me add support for Markdownify-MCP on Windows. PRs exist but I cannot test them. Post here if interested.

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

Getting Started

1. Clone this repository
2. Install dependencies:

   pnpm install
   

Note: this will also install uv and related Python depdencies.

3. Build the project:

   pnpm run build
   

4. Start the server:

   pnpm start
   

Development

• Use pnpm run dev to start the TypeScript compiler in watch mode
• Modify src/server.ts to customize server behavior
• Add 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"
      ],
      "env": {
        // By default, the server will use the default install location of `uv`
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}

Available Tools

• youtube-to-markdown: Convert YouTube videos to Markdown

• pdf-to-markdown: Convert PDF files to Markdown

• bing-search-to-markdown: Convert Bing search results to Markdown

• webpage-to-markdown: Convert web pages to Markdown

• image-to-markdown: Convert images to Markdown with metadata

• audio-to-markdown: Convert audio files to Markdown with transcription

• docx-to-markdown: Convert DOCX files to Markdown

• xlsx-to-markdown: Convert XLSX files to Markdown

• pptx-to-markdown: Convert PPTX files to Markdown

• get-markdown-file: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.

  OPTIONAL: set MD_SHARE_DIR env var to restrict the directory from which files can be retrieved, e.g. MD_SHARE_DIR=[SOME_PATH] pnpm run 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.