📌Overview

Purpose: Markdownify aims to convert various file types and web content into Markdown format for improved readability and shareability.

Overview: Markdownify is a Model Context Protocol (MCP) server designed to streamline the transformation of diverse content types—such as documents, media files, and web pages—into Markdown. This tool enhances the usability of content by making it easily editable and compatible with Markdown-based applications.

Key Features:

Multi-Format Conversion: Supports conversion of various file types, including PDFs, images, audio files (with transcription), DOCX, XLSX, and PPTX to Markdown.
Web Content Conversion: Enables the extraction of Markdown from online resources such as YouTube video transcripts, Bing search results, and general web pages, simplifying information retrieval.

Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format, making it easy to read and share.

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

Clone this repository.
Install dependencies:
```
pnpm install
```
Build the project:
```
pnpm run build
```
Start the server:
```
pnpm start
```

Development

Start the TypeScript compiler in watch mode:
```
pnpm run dev
```
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": {
        "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.

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.

markdownify-mcp