mcpField
M
md-to-docx

md-to-docx

github.com/githubDocuments40.5k357 installsUpdated 1d ago
Repository

About md-to-docx

A skill that converts Markdown files into formatted Word documents with PNG images. It uses JavaScript packages to generate title pages, tables of contents, and styled document content without native binaries.

Key features

  1. 01Markdown-to-DOCX conversion
  2. 02YAML front-matter title pages
  3. 03Table of contents from H1–H3
  4. 04Inline PNG image embedding
  5. 05Styled tables and code blocks
  6. 06Support for Markdown elements

Use cases

  1. 01Creating a Word report from Markdown
  2. 02Preparing a document with a title page and contents
  3. 03Converting Markdown that includes PNG diagrams

Install

Copy the command and run it in a terminal.

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

After installing, type/md-to-docxin Claude Code to confirm it loaded.

Bundled filesscripts/md-to-docx.mjsscripts/package.json

Details

From the project README

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

FilePurpose
SKILL.mdThis instruction file
scripts/md-to-docx.mjsNode.js Markdown-to-Word converter
scripts/package.jsonDependencies (docx, marked)

Prerequisites

RequirementVersionNotes
Node.js18+Required runtime
docx9+Pure JS Word document generator
marked15+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.

Comments

Markdown supported