MCP ConfigsMay 12, 2026·2 min read

Markdownify MCP — Convert Files and URLs to Markdown

Markdownify MCP is an MCP server that converts PDFs, images, audio, and web pages into Markdown, with optional path allowlists for safer local file access.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install aa44dfd3-85b6-40f6-9dfc-31f26f8e1429 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

Markdownify MCP is an MCP server that converts PDFs, images, audio, and web pages into Markdown, with optional path allowlists for safer local file access.

  • Best for: agents that need document-to-Markdown ingestion (PDF/web/audio) before summarizing or indexing
  • Works with: Bun/Node, optional Docker, optional MD_ALLOWED_PATHS allowlist
  • Setup time: 15–30 minutes

Practical Notes

  • Data point: Docker mode can enforce a read boundary via MD_ALLOWED_PATHS.
  • Quant: mount only one directory first (e.g. /data) to reduce accidental file exposure.

Pattern: convert → then summarize

When an agent reads arbitrary documents, keep the pipeline explicit:

  1. Convert to Markdown (normalize),
  2. store the Markdown (cache),
  3. summarize / chunk / index.

This avoids repeated parsing and makes outputs auditable.

Security note

If your agent has local file access, always restrict paths (allowlist) and run conversion in a container when possible.

FAQ

Q: Does it support PDFs? A: Yes. The repo lists pdf-to-markdown and related tools.

Q: How do I restrict what it can read? A: Set MD_ALLOWED_PATHS to an allowlist of directories.

Q: Should I run it in Docker? A: If you’re exposing local files, Docker + read-only mounts is a safer default.

🙏

Source & Thanks

Source: https://github.com/zcaceres/markdownify-mcp > License: MIT > GitHub stars: 2,673 · forks: 223

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets