# Markdownify

Markdownify is a self-hosted ai app. A Model Context Protocol server for converting almost anything to Markdown It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5971/markdownify

## Description

A Model Context Protocol server for converting almost anything to Markdown

## Platform availability

Available on 0 of 10 platforms.

## Health score

45/100 (Fair), based on 4 of 5 factors.
- Maintained: 53 (last commit 203 days ago)
- Popular: 70 (3,006 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 20 (1 serious finding, 6 minor, tests)

## Security check

1 serious finding: Uses certifi 2026.2.25, which has a known critical vulnerability.
Automated checks on commit 024f97c, 21 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/zcaceres/markdownify-mcp
- Docker Hub: https://hub.docker.com/r/mcp/markdownify

## Common questions

### How do I run Markdownify MCP from the source repository?

Clone the repository, run bun install to create the Python virtual environment at .venv and install markitdown[all], then run bun run build and start the server with bun start.

### How do I restrict which directories the server can read?

Set MD_ALLOWED_PATHS to a path-delimiter-separated list of directories, using colons on POSIX and semicolons on Windows. If it is unset, the file-input tools are unrestricted.

### How do I use a system-installed markitdown instead of the bundled virtual environment?

Set MARKITDOWN_PATH to the absolute path of the markitdown executable. By default the server tries the bundled .venv path and then markitdown on PATH.

### Why do audio and image conversion tools fail in the published Docker image?

The published Docker image installs only markitdown[pdf]. Audio transcription and image OCR require the markitdown[all] extras.

---
Source: Our Local Host (https://ourlocalhost.com/app/5971/markdownify), the self-hosted and open-source app directory.
