md-to-docx by github

Decision brief

What it does—and where it fits

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.

Best for

Not for

Tasks that require unconfirmed production actions or broad system permissions.
Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

Platform	Status	Evidence	What to check
Codex	Not declared	No explicit evidence	Portability before use
Claude Code	Not declared	No explicit evidence	Portability before use
Cursor	Not declared	No explicit evidence	Portability before use
Gemini CLI	Not declared	No explicit evidence	Portability before use

Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource

npx skills add https://github.com/github/awesome-copilot --skill "skills/md-to-docx"

Safe inspection promptEditorial

Inspect the Agent Skill "md-to-docx" from https://github.com/github/awesome-copilot/blob/9933dcad5be5caeb288cebcd370eeeb2fc2f1685/skills/md-to-docx/SKILL.md at commit 9933dcad5be5caeb288cebcd370eeeb2fc2f1685. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

01
How to Convert
Review the “How to Convert” section in the pinned source before continuing.
Review and apply the “How to Convert” source section.
02
Install dependencies (one-time, from the scripts folder)
cd skills/md-to-docx/scripts && npm install
cd skills/md-to-docx/scripts && npm install
03
Convert (run from workspace root)
node skills/md-to-docx/scripts/md-to-docx.mjs [output.docx] markdown High-Level Architecture yaml --- title: Project Name — Project Summary date: 2025-01-15 version: 1.0 audience: Engineering Team, Architects, Stakeholders ---
node skills/md-to-docx/scripts/md-to-docx.mjs [output.docx] markdown High-Level Architecture yaml --- title: Project Name — Project Summary date: 2025-01-15 version: 1.0 audience: Engineering Team, Architects, Stakehold…The title is split on — or – into main title and subtitle for the title page.
04
Skill Folder Contents
Review the “Skill Folder Contents” section in the pinned source before continuing.
Review and apply the “Skill Folder Contents” source section.

Permission review

Static risk signals and limitations

Runs scripts

medium · line 12

The documentation asks the agent to run terminal commands or scripts.

node skills/md-to-docx/scripts/md-to-docx.mjs <input.md> [output.docx]

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial

Signal	Value	Evidence type	Meaning
Quality score	67/100	Computed	Documentation, specificity, maintenance, and trust rules
Repository stars	37,126	Source	Repository attention, not individual Skill quality
Compatibility	0 platforms	Source	Declared in the catalog source record
Usage guide	automated source guide	Editorial	Generated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository: github/awesome-copilot
Skill path: skills/md-to-docx/SKILL.md
Commit: 9933dcad5be5caeb288cebcd370eeeb2fc2f1685
License: MIT
Collected: 2026-07-28
Default branch: main

View the original SKILL.md

Markdown 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, audience for 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 ![alt](path) references relative to the input .md file, 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:

![High-Level Architecture](diagrams/high-level-architecture.drawio.png)

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.