Markdownify

A Model Context Protocol server for converting almost anything to Markdown

  • AI
  • Tools & Utilities
A Model Context Protocol server for converting almost anything to Markdown

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

45/100 Fair

Maintained
53last commit 203 days ago
Popular
703,006 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 6 minor, tests

Based on 4 of 5 factors.

GitHub stars
3,006
Open issues
32
Last commit
2026-05-01
Latest release
v1.1.0
License
MIT
Activity
stale

Checked 2 days ago - source: GitHub (zcaceres/markdownify-mcp)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install it with pip first Run `pip install markdownify` on the computer where you will use it; pip is the tool that installs Python packages. If you get a permission error, use a virtual environment (a separate Python package folder) so you do not break system apps. source
  • Check the file path before running If you run `markdownify page.html`, make sure that exact file is in the current folder or use a full path. If the file name or folder is wrong, it stops with 'No such file or directory' and you will not get any Markdown. source
  • Start with the default settings You can run it without changing heading, bullet, or line-break options; they only control how the finished Markdown looks. Adjust them only if the output style is not what you want, because these choices do not affect whether the install works. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads