npm package: @nova-mind-cloud/md-to-docx
Description: Nova MCP Server - Convert Markdown to DOCX with custom styling
Author: Charles Annoni
Latest version: 1.0.0

# @nova-mind-cloud/md-to-docx

[![npm version](https://img.shields.io/npm/v/@nova-mind-cloud/md-to-docx.svg)](https://www.npmjs.com/package/@nova-mind-cloud/md-to-docx)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

# 📝 Free & Open Source MD to DOCX MCP

**Convert Markdown files to DOCX with professional styling.**

✅ **Free to use** - No subscription required
🔓 **Open source** - MIT License

---

## ✨ Features

- 📝 **MD to DOCX Conversion** - Professional document generation
- 🎨 **Custom Styling** - Fonts, sizes, line height control
- 📋 **Full Markdown Support** - Headings, lists, code, tables, quotes
- 🔤 **Typography** - Open Sans default, fully customizable
- ⚡ **Fast Processing** - markdown-it + html-docx-js engine
- 📄 **Universal Format** - Compatible with Word, Google Docs, LibreOffice

---

## 📦 Installation

### With Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "md-to-docx": {
      "command": "npx",
      "args": ["-y", "@nova-mind-cloud/md-to-docx@latest"]
    }
  }
}
```

**Config location:**
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`

---

## 🚀 Usage

### Convert Markdown to DOCX

```
Convert my article.md file to DOCX format
```

**What happens:**
1. Reads Markdown file
2. Converts to styled HTML
3. Generates professional DOCX
4. Returns output path

### Custom Styling

```
Convert blog.md to blog.docx with Arial font and 12pt size
```

---

## 📋 Available Tools

### `convertMdToDocx`
Convert a Markdown file to DOCX with custom styling.

**Parameters:**
- `inputPath` (required) - Path to input Markdown file
- `outputPath` (required) - Path where DOCX will be saved
- `fontFamily` (optional) - Font family (default: "Open Sans")
- `fontSize` (optional) - Font size in points (default: 11)
- `lineHeight` (optional) - Line height multiplier (default: 1.6)

---

## 📐 Markdown Support

### Supported Elements

- **Headings** (H1-H6) with differentiated styles
- **Lists** (ordered and unordered)
- **Links** with blue hypertext styling
- **Bold and Italic** text
- **Code** (inline and blocks)
- **Tables** with borders
- **Blockquotes** with left border
- **Paragraphs** with optimized spacing

### Default Styling

- **Font:** Open Sans (fallback: Segoe UI, Arial)
- **Base size:** 11pt
- **Line height:** 1.6
- **Colors:** Black/gray text, blue links
- **Code:** Consolas monospace with gray background

---

## 🔧 Troubleshooting

### File Not Found

**Problem:** "Input file not found" error

**Solutions:**
- Verify file path is correct and absolute
- Check file has .md extension
- Ensure read permissions on file
- Try with full path instead of relative

### Conversion Fails

**Problem:** Conversion starts but fails

**Solutions:**
- Check Markdown syntax is valid
- Ensure sufficient disk space
- Verify output directory exists or can be created
- Try with simpler Markdown first

### Styling Issues

**Problem:** Font or styling not applied correctly

**Solutions:**
- Use standard font names (Arial, Calibri, etc.)
- Check font is installed on system
- Try default styling first
- Verify DOCX opens correctly in Word/LibreOffice

---

## 📄 License

MIT © Charles Annoni

---

## 🔗 Links

- [NPM Package](https://www.npmjs.com/package/@nova-mind-cloud/md-to-docx)
- [Report Issues](https://github.com/nova-mind-cloud/md-to-docx/issues)
- [MCP Documentation](https://modelcontextprotocol.io)

---

## 🙏 Credits

Created by **Charles Annoni** ([GDM-Pixel](https://gdm-pixel.fr))

Part of the **Nova-Mind** ecosystem - AI-powered coaching platform.