docx-to-markdown

Installation Required

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

mammoth

turndown

@truto/turndown-plugin-gfm

Quick Start

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

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

# Extract images to directory
node .claude/skills/docx-to-markdown/scripts/convert.cjs \
  --file ./doc.docx \
  --output ./output/doc.md \
  --images ./output/images/

CLI Options

--file <path>

--output <path>

--images <dir>

Output Format (JSON)

{
  "success": true,
  "input": "/path/to/input.docx",
  "output": "/path/to/output.md",
  "wordCount": 1523,
  "images": 5,
  "warnings": ["Some formatting may be simplified"]
}

Supported Elements

• Headings (H1-H6)
• Paragraphs and emphasis (bold, italic, strikethrough)
• Ordered and unordered lists
• Tables (GFM format)
• Links
• Images (extracted or base64)
• Code blocks (requires Word "Code" style)
• Blockquotes

Known Limitations

• Nested lists: Numbering may reset in deeply nested lists
• Nested tables: Inner tables are flattened
• Code blocks: Require explicit Word style mapping ("Code" or "Code Block")
• Complex formatting: Some advanced formatting may be simplified
• Footnotes: Converted but may lose some formatting

Google Docs Support

1. In Google Docs: File → Download → Microsoft Word (.docx)
2. Run this converter on the downloaded file

Troubleshooting

npm install

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