Markdownify
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.
Security check: 1 serious finding
- Uses certifi 2026.2.25, which has a known critical vulnerability (PyPI)
Automated checks on commit 024f97c, 21 Oct 2026. Not an audit.
- 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
Variants
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
- Selfhost markdown wiki - wikmd : r/selfhosted - Reddit (reddit)
- Online Markdown Editor : r/selfhosted - Reddit (reddit)
- Self-hosted markdown publish solution for non-technical people? - Reddit (reddit)
- Self-hosted, web-based markdown editor with filesystem browsing - Reddit (reddit)
- Self-Hosted Markdown Editor (Docker) : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads