MarkItDown MCP
Provides tools for integrating with Sublime Text, including installing MarkdownPreview styles, previewing Markdown files, and opening generated Markdown files in Sublime Text.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MarkItDown MCP convert the file report.html to Markdown and preview it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MarkItDown MCP
Convert plain text, .txt notes, JSON, CSV, and HTML into Wiki-ready Markdown.
Preview CSS + Copy toolbar JS ship inside this package:
styles/rts-markdown-common.css
styles/rts-markdown-copy.jsNo dependency on Organized-Reference for styles.
Install
npm i -g @mhdd_24/markitdown-mcp
# or npx in Cursor mcp.jsonRelated MCP server: MarkItDown MCP Server
Cursor mcp.json
"markitdown": {
"command": "npx",
"args": ["-y", "@mhdd_24/markitdown-mcp"],
"env": {
"MARKITDOWN_WORKDIR": "D:/Sublime - Related RTS/Organized-Reference",
"MARKITDOWN_OUTDIR": "D:/Sublime - Related RTS/Organized-Reference",
"SUBLIME_EXE": "C:/Program Files/Sublime Text/subl.exe"
}
}Tools
Tool | Purpose |
| Workdir / outdir / package styles / Sublime |
| Paths to package |
| Wire Sublime MarkdownPreview to package styles |
| Content or file → formatted |
| Convert folder + index |
| Normalize existing |
| Open |
First-time Sublime setup
In chat: md_install_styles
Then open any .md → Ctrl+Shift+M → Copy Markdown / Copy Formatted.
License
ISC
Available Tools
7 toolsmd_convertB
Convert plain text content or a file (.txt/.json/.csv/.html/.md and more) into properly formatted Wiki-ready Markdown. Writes a .md file under MARKITDOWN_OUTDIR (or outputPath). Output is pure Markdown so Sublime MarkdownPreview can use this package styles/ CSS + Copy Markdown / Copy Formatted buttons.
Inputs: title, content, inputPath, overwrite, +3 more.
md_convert_batchA
Convert all matching files in a folder (default *.txt) to Markdown. Same formatting rules as md_convert.
Inputs: folder (required), globExt, recursive, writeIndex.
md_formatA
Normalize an existing .md file (fence spacing, blank lines around tables/headings) without removing content. Keeps Wiki + Sublime preview consistency.
Inputs: inputPath (required), inPlace.
md_install_stylesB
Wire Sublime Text MarkdownPreview to this package styles/ folder (CSS + Copy JS). Writes/updates Packages/User/MarkdownPreview.sublime-settings.
Inputs: force.
md_previewB
Open a Markdown file in Sublime Text. Preview with Ctrl+Shift+M uses this package styles/ CSS + Copy Markdown / Copy Formatted.
Inputs: path (required).
md_statusB
Check MarkItDown MCP: workdir, outdir, package-local styles (CSS/JS Copy toolbar), and optional Sublime path.
Inputs: no named parameters.
md_stylesA
Report package-local style/JS paths (markitdown-mcp/styles/rts-markdown-common.css + rts-markdown-copy.js) and whether they exist.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct operation: status, styles, install styles, convert, batch convert, format, and preview. The only potential confusion is between md_status and md_styles, since both report on style paths and package state, but their purposes are still reasonably separable.
All tools consistently use the md_ prefix and snake_case, with most names following a verb-first pattern like md_convert, md_format, and md_preview. The exceptions are the two noun-style informational commands md_status and md_styles, but they remain predictable and easy to distinguish.
Seven tools is well-scoped for this server's purpose: conversion, batch conversion, formatting, preview, and style setup are all represented without redundant filler. Each tool earns its place in the workflow.
The tool set covers the full Markdown workflow: converting files, batch conversion, normalizing existing markdown, previewing in Sublime, and managing the styles needed for proper rendering. There are no obvious dead ends or missing core operations for the stated domain.
Maintenance
Related MCP Connectors
Hosted MarkItDown: convert Word, PowerPoint, Excel, HTML and the text of PDFs to Markdown.
Convert Markdown to PDF, DOCX, HTML or EPUB with formatting and display options.
Turn Markdown or plain text into a clean PDF document to print or share, plus an editable Word file.
PDF, Word, PowerPoint and Excel to clean Markdown plus every table as JSON rows, OCR for scans.
Related MCP Servers
- AlicenseAqualityDmaintenanceConverts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.10681 npm3,004MIT
- AlicenseNot gradedqualityDmaintenanceConverts various file formats to Markdown using the MarkItDown utility and can be integrated with MCP clients for seamless document processing and conversion.88MIT
- FlicenseNot gradedqualityDmaintenanceEnables seamless content conversion between multiple formats including Markdown, HTML, and DOCX directly within development environments.11 npm-
- AlicenseAqualityDmaintenanceConvert Markdown into boardroom-grade DOCX, PDF, and HTML using your own custom Word templates — or any of MDMagic's 15 designer-built ones across Business, Creative, Professional, and Technical. Ten tools cover conversion, template recommendations, cost estimation, and markdown validation.1071 npmMIT