Markdownify

Markdownify

MCP to convert almost anything to Markdown (PPTX, HTML, PDF, Youtube Transcripts and more)

2,274
Stars
192
Forks
0
Releases

Overview

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a toolkit to transform PDFs, images, audio files (with transcription), DOCX, XLSX, and PPTX into clean Markdown text. It can also convert web content such as YouTube video transcripts, Bing search results, and general web pages into Markdown, enabling easy sharing and editing. In addition to on-demand conversions, it can retrieve existing Markdown files from a configured location. The server exposes a set of dedicated tools (youtube-to-markdown, pdf-to-markdown, bing-search-to-markdown, webpage-to-markdown, image-to-markdown, audio-to-markdown, docx-to-markdown, xlsx-to-markdown, pptx-to-markdown, get-markdown-file) to handle different inputs. It is designed to be integrated with desktop apps via a standard MCP server configuration; the example shows a markdownify entry with a node command and dist/index.js, and an optional UV_PATH environment variable. Development uses TypeScript; modify src/server.ts to customize behavior and add or modify tools in src/tools.ts. The project supports building with pnpm, starting the server, and optional restrictions like MD_SHARE_DIR for file retrieval.

Details

Owner
zcaceres
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Convert multiple file types to Markdown

Supports PDFs, images, audio (with transcription), DOCX, XLSX, and PPTX conversions to Markdown.

Convert web content to Markdown

Converts YouTube transcripts, Bing search results, and general web pages to Markdown.

Retrieve existing Markdown files

Allows fetching existing Markdown files from configured locations.

Audience

DevelopersEmbed the Markdownify MCP server into apps to convert inputs to Markdown.
Desktop appsConfigure MCP to run server in desktop apps for on-demand Markdown conversion.
Content creatorsAutomate Markdown generation from media and pages within content pipelines.

Tags

MarkdownMCPfile-conversionPDFImagesAudio-transcriptionDOCXXLSXPPTXYouTube-transcriptsWeb-pagesBing-searchImage-metadataMarkdown-files