MarkItDown: ¡una útil herramienta de IA para convertir archivos y documentos de oficina a Markdown! 121

小编 ·

MarkItDown: ¡una útil herramienta de IA para convertir archivos y documentos de oficina a Markdown!

MarkItDown es una herramienta de código abierto respaldada por Microsoft que convierte diversos formatos de archivo (PDF, Word, Excel, PowerPoint, imágenes, audio, páginas web, etc.) a Markdown. Además, está especialmente optimizada para aplicaciones con LLM, generando contenido fácil de leer para humanos y un formato de entrada ideal para LLMs.

MarkItDown: ¡una útil herramienta de IA para convertir archivos y documentos de oficina a Markdown!

¿Qué es MarkItDown?

MarkItDown es una herramienta de código abierto respaldada por Microsoft capaz de convertir múltiples formatos de archivo (como PDF, Word, Excel, PowerPoint, imágenes, audio, páginas web, etc.) a formato Markdown. Además, está especialmente optimizada para aplicaciones con LLM, de modo que el contenido resultante no solo es adecuado para la lectura humana, sino que también constituye un formato de entrada ideal para los LLM.

MarkItDown MCP:将网页链接、本地文件以及数据转换为Markdown格式.jpg

Características y funcionalidades de MarkItDown

  • Soporte multiformato: admite la conversión de PDF, Word, Excel, PPT, imágenes (incluido reconocimiento OCR), audio (voz a texto), HTML, páginas web (como enlaces de YouTube) y otros formatos a Markdown estructurado. Además, conserva el contenido esencial como la jerarquía de encabezados y la estructura de tablas, lo que resulta adecuado para la comprensión y el análisis por parte de la IA.

  • Integración del protocolo MCP: como servidor MCP, permite que herramientas de IA (como Claude Desktop) invoquen la función de conversión de archivos mediante un protocolo estándar, logrando "instrucciones de voz para procesamiento de archivos" sin necesidad de programación. Por ejemplo, cuando el usuario dice "convierte este PDF a Markdown", la IA puede invocar automáticamente MarkItDown para completar la conversión.

Escenarios de aplicación de MarkItDown

  • Investigación académica: convierte rápidamente artículos y literatura a Markdown, lo que facilita el análisis de textos.

  • Automatización de oficina: convierte grabaciones de reuniones, PPT, etc., en notas estructuradas.

  • Flujo de trabajo con IA: combinado con LLM, permite la automatización completa de "instrucciones de voz → procesamiento de archivos → resumen de contenido".

¿Cómo instalar y usar MarkItDown?

1. Instalación e inicio

  • Modo línea de comandos:

pip install markitdown-mcp
markitdown-mcp  # 启动 STDIO 模式
markitdown-mcp --sse --host 127.0.0.1 --port 3001  # 启动 SSE 服务[2,4,5](@ref)
  • Despliegue con Docker:

docker build -t markitdown-mcp:latest .
docker run -it --rm markitdown-mcp:latest  # 默认 STDIO 模式
docker run -it --rm -v /本地目录:/workdir markitdown-mcp:latest  # 挂载本地文件[4,5](@ref)

2. Configuración con Claude Desktop

Agregue la siguiente configuración en claude_desktop_config.json para habilitar el servicio MarkItDown MCP:

{
"mcpServers": {
"markitdown": {
"command": "docker",
"args": ["run", "--rm", "-i", "-v", "/本地目录:/workdir", "markitdown-mcp:latest"]
}
}
}

Tras la configuración, Claude puede invocar directamente la función de conversión de archivos.

3. Llamada a la API de Python

from markitdown import MarkItDown
md = MarkItDown(enable_plugins=True)
result = md.convert("input.pdf")  # 转换为 Markdown 文本
print(result.text_content)

Admite la integración de modelos LLM (como GPT-4o) a través del parámetro llm_client para optimizar la salida.

github:https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp