markdownify-mcp MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

10 conversores: PDF, DOCX, XLSX, PPTX, imagens, áudio, YouTube, busca Bing, páginas da web
Formato uniforme de ferramenta: forneça um caminho ou URL, obtenha markdown
Transcrição de áudio via backend compatível com OpenAI Whisper
Funciona com arquivos locais e URLs remotas
Baseado em Node; transporte stdio

Demo ao vivo

Como fica na prática

markdownify.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "markdownify": {
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "markdownify",
      "command": "npx",
      "args": [
        "-y",
        "markdownify-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "markdownify": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "markdownify-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add markdownify -- npx -y markdownify-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: markdownify-mcp

Como ingerir uma pasta de PDFs em uma base de conhecimento markdown

👤 Construtores de RAG, gerenciadores de conhecimento ⏱ ~30 min intermediate

Quando usar: Você tem 50 artigos de pesquisa em PDF e quer texto limpo para incorporar.

Pré-requisitos

pnpm — npm i -g pnpm
Instalar + executar — git clone the repo, pnpm install, pnpm start

Fluxo

Enumerar arquivos

Listar todos os arquivos .pdf em /library/papers/.✓ Copiado

→ Lista de caminhos
Converter em lote

Para cada um, chame pdf-to-markdown. Escreva a saída em /library/markdown/<same-name>.md.✓ Copiado

→ Arquivos Markdown aparecem
Verificar um

Mostre-me os primeiros 500 caracteres de /library/markdown/attention-is-all-you-need.md.✓ Copiado

→ Markdown legível, sem artefatos de PDF

Resultado: Uma árvore /markdown/ paralela pronta para incorporar.

Armadilhas

PDFs digitalizados (apenas imagem) produzem markdown vazio — Pré-OCR PDFs digitalizados antes da conversão
PDFs com muita matemática perdem equações — Para matemática, tente emparelhar com Mathpix ou o modelo nougat OCR separadamente

Combine com: filesystem

Como transformar uma gravação de reunião em notas pesquisáveis

👤 Qualquer pessoa que esteja gravando reuniões ⏱ ~10 min beginner

Quando usar: Pós-chamada, antes da memória desaparecer.

Pré-requisitos

Chave OpenAI para Whisper — platform.openai.com (ou qualquer endpoint compatível com Whisper)

Fluxo

Transcrever

audio-to-markdown em /recordings/2026-04-14-standup.m4a.✓ Copiado

→ Markdown com timestamps
Extrair ações

A partir da transcrição, liste itens de ação com proprietários.✓ Copiado

→ Lista de verificação de ações

Resultado: Notas de reunião pesquisáveis + ações.

Armadilhas

Whisper rotula incorretamente os falantes — Para diarização de falante, use uma ferramenta especializada; markdownify fornece apenas texto

Combine com: notion

Como resumir um vídeo do YouTube sem assistir

👤 Pesquisadores, aprendizes ⏱ ~5 min beginner

Quando usar: Um vídeo de 90 minutos no seu feed quando você tem 5 minutos.

Fluxo

Puxar transcrição

youtube-to-markdown https://youtu.be/xyz123.✓ Copiado

→ Markdown de transcrição
Resumir

Resuma em 5 pontos + timestamps principais.✓ Copiado

→ Resumo com marcadores e pontos de pulo

Resultado: Decisão sobre assistir ou não ao vídeo de verdade.

Armadilhas

Alguns vídeos têm legendas desativadas — A ferramenta retorna vazio — recorra a audio-to-markdown se você tiver o arquivo

Combinações

Combine com outros MCPs para 10× de alavancagem

markdownify + filesystem

Converter em lote uma pasta de entrada em uma pasta de base de conhecimento

Converta cada arquivo em /inbox/ para markdown em /kb/ preservando a árvore de diretórios.✓ Copiado

markdownify + notion

Solte documentos convertidos diretamente em Notion

Converta o PDF /specs/rfq-2026.pdf e crie uma página Notion com o resultado.✓ Copiado

markdownify + excel

Combine xlsx-to-markdown com excel MCP para viagem de ida e volta

Leia a planilha /report.xlsx 'Resumo', converta para markdown e salve em /docs/report.md.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
pdf-to-markdown	path_or_url: str	Converter PDFs	gratuito (local)
docx-to-markdown	path_or_url: str	Documentos Word	gratuito
xlsx-to-markdown	path_or_url: str	Planilhas como tabelas	gratuito
pptx-to-markdown	path_or_url: str	Apresentações	gratuito
image-to-markdown	path_or_url: str	Imagens	gratuito ou 1 chamada LLM se OCR habilitado
audio-to-markdown	path: str	Áudio/memorandos de voz	1 chamada Whisper ($0.006/min)
youtube-to-markdown	url: str	Legendas do YouTube	gratuito
webpage-to-markdown	url: str	Texto da web legível	gratuito
bing-search-to-markdown	query: str	Busca rápida na web	gratuito
get-markdown-file	path: str	Recuperar uma conversão anterior	gratuito

Custo e limites

O que custa rodar

Cota de API: Nenhuma para conversores locais; Whisper/OpenAI para áudio
Tokens por chamada: Depende do tamanho do documento
Monetário: Gratuito, exceto transcrição de áudio (~$0.006/min via Whisper)
Dica: Para grandes lotes de PDF, faça a conversão antes de colar no LLM — mais barato do que pedir ao Claude para analisar PDFs diretamente.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Leitura do sistema de arquivos em arquivos de origem, escrita em saída

Armazenamento de credenciais: OPENAI_API_KEY (para áudio) em env

Saída de dados: Conversores locais permanecem locais. Áudio vai para seu endpoint Whisper.

Nunca conceda: Não execute URLs não confiáveis através de webpage-to-markdown sem sandbox — risco de SSRF

conversores pptx/docx ocasionalmente perdem formatação; revise antes de usar como fonte de verdade.

Solução de problemas

Erros comuns e correções

pnpm install falha

Versão do Node muito antiga — requer Node 18+. nvm install 20.

Verificar: node -v

pdf-to-markdown retorna string vazia

Provavelmente um PDF digitalizado (apenas imagem). Execute OCR primeiro (ocrmypdf).

youtube-to-markdown 'legendas não disponíveis'

Proprietário do vídeo desativou legendas. Baixe o áudio e use audio-to-markdown em seu lugar.

audio-to-markdown 401

OPENAI_API_KEY ausente ou inválida.

Verificar: echo $OPENAI_API_KEY

Alternativas

markdownify-mcp vs. outros

Alternativa	Quando usar	Troca
markitdown (Microsoft)	Você quer o conversor subjacente diretamente sem MCP	Sem interface MCP; precisa de seu próprio encapsulamento
unstructured.io	Ingestão em escala empresarial com conscientização de layout	Pago para recursos avançados

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills