markdownify-mcp MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

10 converters: PDF, DOCX, XLSX, PPTX, images, audio, YouTube, Bing search, web pages
Uniform tool shape: give a path or URL, get markdown
Audio transcription via OpenAI Whisper-compatible backend
Works with local files and remote URLs
Node-based; stdio transport

라이브 데모

실제 사용 모습

markdownify.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/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
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

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

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

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

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

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: markdownify-mcp

How to ingest a folder of PDFs into a markdown knowledge base

👤 RAG builders, knowledge managers ⏱ ~30 min intermediate

언제 쓸까: You have 50 PDF research papers and want clean text to embed.

사전 조건

pnpm — npm i -g pnpm
Install + run — git clone the repo, pnpm install, pnpm start

흐름

Enumerate files

List every .pdf under /library/papers/.✓ 복사됨

→ Path list
Convert in batch

For each, call pdf-to-markdown. Write the output to /library/markdown/<same-name>.md.✓ 복사됨

→ Markdown files appear
Spot-check one

Show me the first 500 chars of /library/markdown/attention-is-all-you-need.md.✓ 복사됨

→ Legible markdown, no PDF artifacts

결과: A parallel /markdown/ tree ready to embed.

함정

Scanned PDFs (image-only) produce empty markdown — Pre-OCR scanned PDFs before conversion
Math-heavy PDFs lose equations — For math, try pairing with Mathpix or the nougat OCR model separately

함께 쓰기: filesystem

How to turn a meeting recording into searchable notes

👤 Anyone recording meetings ⏱ ~10 min beginner

언제 쓸까: Post-call, before memory fades.

사전 조건

OpenAI key for Whisper — platform.openai.com (or any Whisper-compatible endpoint)

흐름

Transcribe

audio-to-markdown on /recordings/2026-04-14-standup.m4a.✓ 복사됨

→ Markdown with timestamps
Extract actions

From the transcript, list action items with owners.✓ 복사됨

→ Action checklist

결과: Searchable meeting notes + actions.

함정

Whisper mislabels speakers — For speaker diarization, use a specialized tool; markdownify gives you text only

함께 쓰기: notion

How to summarize a YouTube video without watching it

👤 Researchers, learners ⏱ ~5 min beginner

언제 쓸까: A 90-minute video in your feed when you have 5 minutes.

흐름

Pull transcript

youtube-to-markdown https://youtu.be/xyz123.✓ 복사됨

→ Transcript markdown
Summarize

Summarize in 5 bullets + key timestamps.✓ 복사됨

→ Bulleted summary with jump points

결과: Decision on whether to actually watch the video.

함정

Some videos have captions disabled — The tool returns empty — fall back to audio-to-markdown if you have the file

조합

다른 MCP와 조합해 10배 효율

markdownify + filesystem

Batch-convert an inbox folder to a knowledge base folder

Convert every file in /inbox/ to markdown under /kb/ preserving the directory tree.✓ 복사됨

markdownify + notion

Drop converted docs straight into Notion

Convert the PDF /specs/rfq-2026.pdf and create a Notion page with the result.✓ 복사됨

markdownify + excel

Combine xlsx-to-markdown with excel MCP for round-tripping

Read /report.xlsx sheet 'Summary', convert to markdown, and save to /docs/report.md.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
pdf-to-markdown	path_or_url: str	Convert PDFs	free (local)
docx-to-markdown	path_or_url: str	Word docs	free
xlsx-to-markdown	path_or_url: str	Spreadsheets as tables	free
pptx-to-markdown	path_or_url: str	Slide decks	free
image-to-markdown	path_or_url: str	Images	free or 1 LLM call if OCR enabled
audio-to-markdown	path: str	Audio/voice memos	1 Whisper call ($0.006/min)
youtube-to-markdown	url: str	YouTube captions	free
webpage-to-markdown	url: str	Readable web text	free
bing-search-to-markdown	query: str	Quick web search	free
get-markdown-file	path: str	Retrieve a prior conversion	free

비용 및 제한

운영 비용

API 쿼터: None for local converters; Whisper/OpenAI for audio
호출당 토큰: Depends on doc size
금액: Free except audio transcription (~$0.006/min via Whisper)
팁: For large PDF batches, do conversion before pasting into the LLM — cheaper than asking Claude to parse PDFs directly.

보안

권한, 시크릿, 파급범위

최소 스코프: Filesystem read on source files, write on output

자격 증명 저장: OPENAI_API_KEY (for audio) in env

데이터 외부 송신: Local converters stay local. Audio goes to your Whisper endpoint.

절대 부여 금지: Don't run untrusted URLs through webpage-to-markdown without sandboxing — SSRF risk

pptx/docx converters occasionally lose formatting; review before using as source of truth.

문제 해결

자주 발생하는 오류와 해결

pnpm install fails

Node version too old — requires Node 18+. nvm install 20.

확인: node -v

pdf-to-markdown returns empty string

Likely a scanned PDF (image-only). Run OCR first (ocrmypdf).

youtube-to-markdown 'no captions available'

Video owner disabled captions. Download audio and use audio-to-markdown instead.

audio-to-markdown 401

Missing or invalid OPENAI_API_KEY.

확인: echo $OPENAI_API_KEY

대안

markdownify-mcp 다른 것과 비교

대안	언제 쓰나	단점/장점
markitdown (Microsoft)	You want the underlying converter directly without MCP	No MCP interface; needs your own wrapping
unstructured.io	Enterprise-scale ingestion with layout awareness	Paid for advanced features

markdownify-mcp

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: markdownify-mcp

How to ingest a folder of PDFs into a markdown knowledge base

사전 조건

흐름

함정

How to turn a meeting recording into searchable notes

사전 조건

흐름

함정

How to summarize a YouTube video without watching it

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

markdownify-mcp 다른 것과 비교

더 보기

리소스