mcpField
M
markdown-to-docx

markdown-to-docx

github.com/vaceDocuments375207 installsUpdated 3w ago
Repository

About markdown-to-docx

A Python script for converting Markdown files to Microsoft Word DOCX, for users exporting individual documents or processing batches. It supports custom output paths, automatic naming, and batch result summaries.

Key features

  1. 01Convert a single Markdown file
  2. 02Convert multiple files in a batch
  3. 03Generate output filenames automatically
  4. 04Choose an output file or directory
  5. 05Validate inputs and report results

Use cases

  1. 01Convert README.md to DOCX
  2. 02Export Markdown files in a directory
  3. 03Set a custom output name
  4. 04Export a documentation set to a folder

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vace/markdown-docx --skill markdown-to-docx

After installing, type/markdown-to-docxin Claude Code to confirm it loaded.

Bundled filesscripts/convert_md_to_docx.py

Details

From the project README

Markdown to DOCX Converter

Overview

Convert Markdown files to Microsoft Word DOCX format using the markdown-docx npm package. Supports single file and batch conversions with automatic output file naming.

Quick Start

Single file conversion:

python scripts/convert_md_to_docx.py -i document.md

This creates document.docx in the same directory.

Batch conversion:

python scripts/convert_md_to_docx.py -i file1.md file2.md file3.md

Each file is converted to DOCX in its original location.

Custom output location:

python scripts/convert_md_to_docx.py -i document.md -o output/mydoc.docx

Batch to specific directory:

python scripts/convert_md_to_docx.py -i *.md -o output_docs/

Workflow

When a user requests markdown to DOCX conversion:

  1. Identify input files - Confirm which markdown file(s) to convert
  2. Determine output naming - Use auto-naming unless user specifies custom names
  3. Run conversion - Execute the script with appropriate parameters
  4. Report results - Inform user of success and output file location(s)

Common Use Cases

Convert a single markdown file

User: "Convert README.md to DOCX"

python scripts/convert_md_to_docx.py -i README.md
Convert all markdown files in current directory

User: "Convert all my markdown files to Word documents"

python scripts/convert_md_to_docx.py -i *.md
Convert with custom output name

User: "Convert notes.md to report.docx"

python scripts/convert_md_to_docx.py -i notes.md -o report.docx
Convert documentation set to a folder

User: "Convert all docs to DOCX and put them in the exports folder"

python scripts/convert_md_to_docx.py -i docs/*.md -o exports/

Script Details

Location: scripts/convert_md_to_docx.py

Features:

  • Validates input files exist and are markdown format
  • Auto-generates output filenames (input.md → input.docx)
  • Supports custom output paths for single files
  • Supports output directory for batch conversions
  • Creates output directories if they don't exist
  • Provides clear success/failure feedback
  • Returns proper exit codes for automation

Requirements:

  • Python 3+
  • Node.js and npm (for npx)
  • markdown-docx npm package (automatically fetched via npx)

Error Handling

The script handles common errors:

  • Input file not found - Reports missing file path
  • Invalid file type - Ensures input is .md or .markdown
  • npx not available - Checks for Node.js/npm installation
  • Conversion failure - Captures and reports markdown-docx errors

Tips

  • Auto-naming is preferred - The script automatically names output files, reducing friction
  • Batch operations - When converting multiple files, the script shows a summary of successes and failures
  • Path handling - Both absolute and relative paths work for input and output
  • Glob patterns - Shell glob patterns (*.md) can be used for batch operations

Comments

Markdown supported