markdown-to-docx Skill | Agent Skills

markdown-to-docx

Convert markdown files to Microsoft Word (.docx) documents.

Installation Required

cd .claude/skills/markdown-to-docx
npm install

Dependencies: markdown-docx (uses docx internally)

Quick Start

# Basic conversion
node .claude/skills/markdown-to-docx/scripts/convert.cjs \
  --file ./README.md

# Custom output path
node .claude/skills/markdown-to-docx/scripts/convert.cjs \
  --file ./doc.md \
  --output ./output/doc.docx

CLI Options

| Option | Required | Description | | ----------------- | -------- | ---------------------------------------------- | | --file <path> | Yes | Input markdown file | | --output <path> | No | Output DOCX path (default: input name + .docx) |

Output Format (JSON)

{
  "success": true,
  "input": "/path/to/input.md",
  "output": "/path/to/output.docx",
  "wordCount": 1523
}

Supported Markdown Elements

Headings (H1-H6)
Paragraphs and emphasis (bold, italic)
Ordered and unordered lists
Code blocks
Tables (GFM style)
Links and images (local + URL)
Blockquotes

Default Styling

Uses markdown-docx default styling:

Standard Word fonts
Professional formatting
Letter/A4 page size

Troubleshooting

Dependencies not found: Run npm install in skill directory Image not loading: Ensure path is correct; URL images require network access (10s timeout)

IMPORTANT Task Planning Notes

Always plan and break many small todo tasks
Always add a final review todo task to review the works done at the end to find any fix or enhancement needed

Agent Skills: markdown-to-docx

Install this agent skill to your local

Skill Files