converting-markdown-to-word

Convert Markdown files to Word documents with preserved formatting.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mbcoalson/skills --skill converting-markdown-to-word
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: converting-markdown-to-word
Source: https://github.com/mbcoalson/skills/tree/main/.claude/skills/converting-markdown-to-word
Command: npx skills add https://github.com/mbcoalson/skills --skill converting-markdown-to-word

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docx, markdown-it, and includes scripts (resource) components.

What problem does it solve?

This Skill converts Markdown (.md) files to Microsoft Word (.docx) format, enabling easy sharing of meeting notes, documentation, and reports in Word.

Core Features & Use Cases

  • Single File Conversion: Convert one Markdown file to DOCX with preserved formatting.
  • Batch Conversion: Process entire directories of Markdown files.
  • Custom Output: Specify output directory and naming conventions.

Quick Start

Convert meeting-notes.md to Word and save in the same directory.

Frequently Asked Questions about converting-markdown-to-word

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown files to Word documents?

Convert Markdown to Word by running the Skill on your .md files. It parses Markdown syntax using markdown-it and generates .docx files with preserved formatting including headings, lists, tables, code blocks, and links. Node.js v18 or higher is required.

Can I batch convert multiple Markdown files to Word at once?

Yes, batch conversion processes entire directories of Markdown files to Word. Use the --batch flag to convert multiple .md files, and optionally specify an output directory with --output to organize the generated .docx files.

What formatting is preserved when converting Markdown to DOCX?

Markdown to Word conversion preserves headings, lists, tables, code blocks, and links. The docx library handles document generation while markdown-it parses the Markdown syntax, ensuring formatted output matches your source structure.

Do I need Node.js to convert Markdown to Word documents?

Yes, Node.js v18 or higher is required to run Markdown to Word conversion. The Skill uses Node.js runtime with markdown-it for parsing and docx for generating Word documents through command-line options.

Can I customize the output location when converting Markdown to Word?

Yes, specify a custom output directory using the --output flag. By default, the Skill overwrites existing outputs in the same directory, but you can control output paths and naming for both single-file and batch conversions.

What happens to existing Word files when I convert Markdown?

By default, Markdown to Word conversion overwrites existing .docx files in the output directory. Use the --output flag to save conversions to a different location if you need to preserve existing Word documents.