Agent skill · writing content · github
md-to-docx
Convert Markdown files to professionally formatted Word (.docx) documents with embedded PNG images — pure JavaScript, no external tools required
Why this skill is useful
Adds a JavaScript-based tool for converting Markdown to Word documents with specific formatting and image embedding that the AI wouldn't generate on its own.
What it needs
Requires node installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
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 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 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: 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 The title is split on — or – into main title and subtitle for the title page.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/md-to-docx