mcp-md-docx

# MD-DOCX Converter A Python tool for bidirectional conversion between **Markdown** (`.md`) and **Microsoft Word** (`.docx`). Designed to make it easy to move content between Word documents and AI tools like Claude, ChatGPT, and GitHub Copilot. ## What it does - Converts `.md` → `.docx` with correct heading hierarchy (Title, Heading 1–9) - Converts `.docx` → `.md` as clean GitHub Flavored Markdown (GFM) - Runs from a simple desktop shortcut — no command line knowledge needed - Handles headings, bold/italic/strikethrough, lists, task lists, tables, blockquotes, code blocks, images, and hyperlinks See [MarkdownSyntax.md](MarkdownSyntax.md) for the full element mapping and notes on what is preserved, approximated, or dropped. ## Requirements - Windows 10/11 - Python 3.11+ - The following Python packages (installed via pip): ``` pip install markdown-it-py python-docx ``` ## Setup ### 1. Clone the repository ```bash git clone https://github.com/cjwpenner/md-docx-converter.git cd md-docx-converter ``` ### 2. Install dependencies ```bash pip install markdown-it-py python-docx ``` ### 3. Create the desktop shortcut ```bash pip install pywin32 python create_shortcut.py ``` This creates an **MD-DOCX Converter** shortcut on your Windows desktop. `pywin32` is only needed to create the shortcut — it is not required to run the converter itself. ### 4. Run the converter Double-click **MD-DOCX Converter** on your desktop. A console window opens and prompts: ``` MD ↔ DOCX Converter -------------------- Enter file path: ``` Paste or type the full path to your `.md` or `.docx` file and press Enter. The converted file is saved in the same directory with the extension swapped. You can also run directly from the command line: ```bash python md_docx_converter/converter.py ``` ## Conversion notes ### Heading hierarchy The heading level mapping is context-dependent: - **MD → DOCX**: If there is exactly one `#` in the document, it becomes a Word **Title**. All other…