科研 Skill

Markdown 转 Word 工具

md-to-docx

将 Markdown 转换为 Word 文档

官方收录发布者 github-awesome-copilot安全审核通过v0.1.0更新于 2026-06-08

Skill 说明

纯 JS 实现的 Markdown → Word .docx 转换,内嵌 PNG 图像,无外部工具依赖 | 输入:Markdown 文件 | 输出:.docx(内嵌 PNG 图像)

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

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.

常见问题

Markdown 转 Word 工具能做什么?

纯 JS 实现的 Markdown → Word .docx 转换,内嵌 PNG 图像,无外部工具依赖 | 输入:Markdown 文件 | 输出:.docx(内嵌 PNG 图像)。

如何安装Markdown 转 Word 工具?

在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「Markdown 转 Word 工具」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。

Markdown 转 Word 工具需要哪些权限?

该科研 Skill声明需要:本地文件。安装前会再次列出,由你确认后才会生效。

Markdown 转 Word 工具经过官方审核吗?

是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。