Markdown to Word Converter
OfficialFreeEasily convert Markdown files to Word documents.
Free · Opens the source repo
What Markdown to Word Converter does
The Markdown to Word Converter skill allows users to transform Markdown (.md) files into well-formatted Word (.docx) documents. This tool is designed for developers, technical writers, and anyone who frequently works with Markdown and needs to generate professional documents without relying on external tools like Pandoc or LibreOffice. By utilizing pure JavaScript, this skill ensures a lightweight and straightforward installation process, requiring only Node.js and a couple of npm packages.
To use the converter, users simply install the necessary dependencies and run a command from their terminal. The converter processes the input Markdown file, generating a Word document that includes a title page, table of contents, and all relevant content formatted according to standard conventions. The skill supports various Markdown elements, including headings, paragraphs, tables, code blocks, images, and links, ensuring comprehensive coverage of Markdown syntax.
One of the standout features of this skill is its ability to embed PNG images directly into the Word document. Images referenced in the Markdown are automatically scaled and included, preserving their aspect ratio and ensuring a polished final product. Additionally, the converter extracts front-matter data from the Markdown, allowing for customized title pages that include project-specific information such as title, date, version, and intended audience.
Overall, the Markdown to Word Converter skill is an excellent choice for users looking to streamline their document creation process while maintaining a professional appearance. Its ease of use and reliance on pure JavaScript make it a valuable tool for enhancing productivity in documentation workflows.
When to use it
Use this tool when you need to create Word documents from Markdown files, especially when images are involved and a professional layout is required.
When not to use it
This skill is not suitable for users who require complex formatting options beyond what Markdown supports or those who need to convert non-Markdown formats.
What you can build with it
Technical Documentation
Generate comprehensive technical documents from Markdown files, including code examples and diagrams.
Project Reports
Create project reports that include formatted text, tables, and embedded images for stakeholders.
Meeting Notes
Convert meeting notes written in Markdown into a professional Word document for distribution.
How to install Markdown to Word Converter
View source1. Install with the skills CLI
npx skills add github/awesome-copilot/md-to-docx --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by githubMarkdown to Word (.docx) Skill
Convert Markdown (.md) files into professionally formatted Word (.docx) documents with embedded PNG images. Uses pure JavaScript via the docx and marked npm packages — no Pandoc, LibreOffice, or any native binary required.
How to Convert
# Install dependencies (one-time, from the scripts folder)
cd skills/md-to-docx/scripts && npm install
# Convert (run from workspace root)
node skills/md-to-docx/scripts/md-to-docx.mjs <input.md> [output.docx]
If output.docx is omitted, it defaults to <input-basename>.docx in the current directory.
Skill Folder Contents
| File | Purpose |
|---|---|
SKILL.md | This instruction file |
scripts/md-to-docx.mjs | Node.js Markdown-to-Word converter |
scripts/package.json | Dependencies (docx, marked) |
Prerequisites
| Requirement | Version | Notes |
|---|---|---|
| Node.js | 18+ | Required runtime |
docx | 9+ | Pure JS Word document generator |
marked | 15+ | Markdown parser |
No native binaries. No system-level installs. Works on Windows, macOS, and Linux.
Features
The converter:
- Extracts YAML front-matter — uses
title,date,version,audiencefor the title page - Generates a title page — with project name, subtitle, date, version, and audience
- Generates a table of contents — built from H1-H3 headings
- Embeds PNG images — resolves
references relative to the input.mdfile, reads the PNG, and embeds it inline in the Word document - Styled output — Calibri font, colored headings (
#1F3864), styled tables with alternating row colors, code blocks in Consolas - Handles all Markdown elements — headings, paragraphs, tables, code blocks, lists, images, links, horizontal rules
Image Embedding
The converter automatically embeds PNG images referenced in the Markdown:
The image path is resolved relative to the input Markdown file. The PNG is read, dimensions are extracted from the PNG header, and the image is scaled to fit within 6 inches width while preserving aspect ratio.
If an image file is not found, a placeholder [Image not found: <path>] is inserted.
Front-Matter Format
---
title: Project Name — Project Summary
date: 2025-01-15
version: 1.0
audience: Engineering Team, Architects, Stakeholders
---
The title is split on — or – into main title and subtitle for the title page.
Frequently asked questions about Markdown to Word Converter
Similar skills
Agent-Browser Core
Efficient browser automation for AI agents.
Setup My IQ
Effortlessly create and update your personal context portfolio.
CRM Maintenance
Automate HubSpot updates from your calendar and emails.
Zoom MCP
Streamline access to Zoom meeting assets and recordings.
Slack Automation
Automate tasks and extract data from Slack easily.
SMB Onboard
Guides small business owners through initial tool setup.