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

📝 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:

{
  "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
• Report Issues
• MCP Documentation

🙏 Credits

Created by Charles Annoni (GDM-Pixel)

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