How do I install the Markdown To DOCX skill?

Run npx skillmds@latest add tomevault-io/markdown-to-docx-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Markdown To DOCX safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Markdown To DOCX?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Markdown To DOCX free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Markdown To DOCX?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Markdown To DOCX by tomevault-io — Agent Skill

Name: Markdown To DOCX
Author: tomevault-io

Markdown To DOCX

Converts Markdown files (.md, .markdown) to DOCX using the markdown-docx npm package. Supports single and batch conversions, automatically generates output filenames, and creates Microsoft Word documents from Markdown content.

tomevault-io Updated Sep 17, 2026

File contents

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:

Identify input files - Confirm which markdown file(s) to convert
Determine output naming - Use auto-naming unless user specifies custom names
Run conversion - Execute the script with appropriate parameters
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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: markdown-to-docx-2description: Converts Markdown files (.md, .markdown) to DOCX using the markdown-docx npm package. Supports single and batch conversions, automatically generates output filenames, and creates Microsoft Word documents from Markdown content.---# Markdown to DOCX Converter## OverviewConvert 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:**```bashpython scripts/convert_md_to_docx.py -i document.md```This creates `document.docx` in the same directory.**Batch conversion:**```bashpython 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:**```bashpython scripts/convert_md_to_docx.py -i document.md -o output/mydoc.docx```**Batch to specific directory:**```bashpython scripts/convert_md_to_docx.py -i *.md -o output_docs/```## WorkflowWhen a user requests markdown to DOCX conversion:1. **Identify input files** - Confirm which markdown file(s) to convert2. **Determine output naming** - Use auto-naming unless user specifies custom names3. **Run conversion** - Execute the script with appropriate parameters4. **Report results** - Inform user of success and output file location(s)## Common Use Cases### Convert a single markdown fileUser: "Convert README.md to DOCX"```bashpython scripts/convert_md_to_docx.py -i README.md```### Convert all markdown files in current directoryUser: "Convert all my markdown files to Word documents"```bashpython scripts/convert_md_to_docx.py -i *.md```### Convert with custom output nameUser: "Convert notes.md to report.docx"```bashpython scripts/convert_md_to_docx.py -i notes.md -o report.docx```### Convert documentation set to a folderUser: "Convert all docs to DOCX and put them in the exports folder"```bashpython 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 HandlingThe 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---> Converted and distributed by [TomeVault](https://tomevault.io/claim/vace) — claim your Tome and manage your conversions.

Frequently asked questions