# Markdown To Msword Converter

> Converts Markdown files to one MS Word document per file using plugin-local scripts and a folder-allowlist JSON.

- Skill: `richfrem/markdown-to-msword-converter-3` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add richfrem/markdown-to-msword-converter-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/markdown-to-msword-converter-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richfrem/markdown-to-msword-converter-3

---


# Markdown to MS Word Converter

Use this skill when the user wants `.md` files converted into `.docx` across the project, either as single-file conversion or bulk conversion.

## Execution

Run the plugin wrapper script:

```powershell
python plugins/markdown-to-msword-converter/skills/markdown-to-msword-converter/scripts/run_bulk_md_to_docx.py --dry-run
python plugins/markdown-to-msword-converter/skills/markdown-to-msword-converter/scripts/run_bulk_md_to_docx.py --overwrite
```

## Behavior

- One `.docx` output per `.md` file
- Uses plugin-local scripts under `plugins/markdown-to-msword-converter/skills/markdown-to-msword-converter/scripts`
- Scope is controlled by `folders_to_convert.json` (configured folders + optional root `.md` files)
- Bulk mode calls `md_to_docx.py` once per file
- Single-file mode calls `md_to_docx.py` directly

## Link handling

- `md_to_docx.py` writes clickable hyperlinks into the Word document
- `md_to_docx.py` resolves internal `.md` targets to file-based `.docx` URI targets

## Optional flags

- `--root <path>` project root to scan
- `--overwrite` overwrite existing `.docx`
- `--dry-run` preview conversions only
- `--config <path>` path to folder allowlist JSON

## Dependency workflow

- Declare in `plugins/markdown-to-msword-converter/requirements.in`
- Compile with pip-tools to `plugins/markdown-to-msword-converter/requirements.txt`
- Install with `pip install -r plugins/markdown-to-msword-converter/requirements.txt`