Markdownify MCP

Markdownify 是一款基于 Model Context Protocol (MCP) 的多功能文件转换服务，能够将 PDF、图片、音频、网页等多种格式内容转换为 Markdown。它适用于需要快速整理复杂文件或网页内容的用户，例如撰写报告、记录学习笔记或分享知识。

核心功能

Markdownify 提供了多种文件转换工具，支持以下功能：

• PDF转Markdown：将PDF文档中的内容提取并格式化为Markdown格式。
• YouTube视频转Markdown：提取YouTube视频的字幕或语音转录为Markdown格式。
• Bing搜索结果转Markdown：将Bing搜索引擎的结果整理为结构化的Markdown格式。
• 网页内容转Markdown：将任意网页内容提取并保存为Markdown。
• 图片转Markdown：将图片附加说明后转换为Markdown格式。
• 音频转Markdown：将音频文件转换为Markdown，并附带语音转录。
• DOCX转Markdown：将Word文档内容提取为Markdown。
• XLSX转Markdown：将Excel表格内容转换为Markdown。
• PPTX转Markdown：将PowerPoint演示文稿内容提取为Markdown。
• 获取现有Markdown文件：直接检索已有的Markdown文件。

安装方法

Markdownify 的安装过程包括克隆仓库、安装依赖、构建项目和启动服务器。

git clone https://github.com/your-repo.git

pnpm install

pnpm run build

pnpm start

安装过程中还将自动安装 `uv` 及相关 Python 依赖项。

使用方法

Markdownify 提供了多种命令行工具，用户可以根据需求选择合适的工具进行文件转换。

node index.js --tool pdf-to-markdown --input input.pdf --output output.md

node index.js --tool youtube-to-markdown --video-id ABC123 --output transcript.md

以下是一些典型使用场景的示例：

将PDF文件转换为Markdown

node index.js --tool pdf-to-markdown --input report.pdf --output report.md

该命令将公司年度报告的PDF版本转换为Markdown，方便后续编辑。

从YouTube视频提取文字内容

node index.js --tool youtube-to-markdown --video-id QwErTy123 --output lecture.md

该命令提取一段教育类视频的字幕并整理为Markdown。

配置说明

如果需要将 Markdownify 与桌面应用集成，可以在应用的服务器配置中添加以下内容：

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ],
      "env": {
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}

该配置指定了服务器的启动命令和环境变量。

使用场景

Markdownify 适用于多种使用场景，包括但不限于：

• 将PDF文档转换为Markdown格式，便于编辑和分享。
• 从YouTube视频中提取字幕并整理为Markdown，用于学习或记录。
• 将Bing搜索结果整理为结构化的Markdown，便于快速查阅。
• 将网页内容提取为Markdown，用于知识整理或存档。
• 将图片、音频、Office文档等转换为Markdown，便于统一管理。

注意事项

在使用 Markdownify 时，需要注意以下几点：

• 转换质量可能因源文件格式而异。
• 某些高级功能可能需要依赖外部工具。
• 大型文件的处理速度可能较慢。

Markdownify 通过提供多种文件转换工具，帮助用户高效地将各种格式内容转换为 Markdown，适用于多种知识整理和内容管理场景。