# MarkItDown MCP

Convert plain text, `.txt` notes, JSON, CSV, and HTML into **Wiki-ready Markdown**.

Preview CSS + Copy toolbar JS ship **inside this package**:

```text
styles/rts-markdown-common.css
styles/rts-markdown-copy.js
```

No dependency on Organized-Reference for styles.

## Install

```bash
npm i -g @mhdd_24/markitdown-mcp
# or npx in Cursor mcp.json
```

## Cursor `mcp.json`

```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 |
|:-----|:--------|
| `md_status` | Workdir / outdir / package styles / Sublime |
| `md_styles` | Paths to package `styles/` CSS + JS |
| `md_install_styles` | Wire Sublime MarkdownPreview to package styles |
| `md_convert` | Content or file → formatted `.md` |
| `md_convert_batch` | Convert folder + index |
| `md_format` | Normalize existing `.md` spacing |
| `md_preview` | Open `.md` in Sublime |

## First-time Sublime setup

In chat: **md_install_styles**  
Then open any `.md` → **Ctrl+Shift+M** → Copy Markdown / Copy Formatted.

## License

ISC