How do I install the Md To DOCX skill?

Run npx skillmds@latest add marielynneblock/md-to-docx 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 Md To DOCX safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Md 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 Md To DOCX free to use?

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

Who published Md To DOCX?

MarieLynneBlock (@marielynneblock) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Md To DOCX by marielynneblock — Agent Skill

Name: Md To DOCX
Author: MarieLynneBlock

File contents

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, coloured headings (#1F3864), styled tables with alternating row colours, 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.

---name: md-to-docxdescription: Convert Markdown files to professionally formatted Word (.docx) documents with embedded PNG images — pure JavaScript, no external tools required---# Markdown to Word (.docx) SkillConvert 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```bash# 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.## FeaturesThe 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, coloured headings (`#1F3864`), styled tables with alternating row colours, code blocks in Consolas- **Handles all Markdown elements** — headings, paragraphs, tables, code blocks, lists, images, links, horizontal rules## Image EmbeddingThe converter automatically embeds PNG images referenced in the Markdown:```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```yaml---title: Project Name — Project Summarydate: 2025-01-15version: 1.0audience: Engineering Team, Architects, Stakeholders---```The title is split on `—` or `–` into main title and subtitle for the title page.

Frequently asked questions

Md To DOCX