Markdownify 是一款模型上下文协议（MCP）服务器，可将各种文件类型和网页内容转换为 Markdown 格式。它提供一套工具，将 PDF、图片、音频文件、网页等转换为易于阅读和共享的 Markdown 文本。

特色

• 将多种文件类型转换为Markdown：
• PDF
• 图片
• 音频（含转录）
• DOCX
• XLSX
• PPTX
• 将网页内容转换为Markdown：
• YouTube视频文字记录
• 必应搜索结果
• 综合网页
• 检索现有的 Markdown 文件

开始

1. 克隆此仓库
2. 安装依赖：

preinstall 步骤在 .venv 创建 Python 虚拟环境并安装 markitdown[all]。

3. 建设项目：

4. 启动服务器：

发展

• 使用 bun run dev 以观察模式启动 TypeScript 编译器
• 修改src/server.ts以定制服务器行为
• 添加或修改[src/tools.ts中的工具

桌面应用的使用

要将此服务器与桌面应用集成，请在应用的服务器配置中添加以下内容：

环境变量

所有路径默认使用合理的数值;只有当默认值不符合你的安装布局时才会覆盖。

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

Getting Started

1. Clone this repository

2. Install dependencies:

   bun install
   

   The preinstall step creates a Python virtual environment at .venv and installs markitdown[all].

3. Build the project:

   bun run build
   

4. Start the server:

   bun start
   

Development

• Use bun 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"
      ]
    }
  }
}

Environment variables

All paths default to sensible values; override only when the defaults don’t fit your install layout.

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-mcp

Notes 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).