mcpField
M
md-to-docx

md-to-docx

github.com/github文档处理40.5k357 次安装今天更新
代码仓库

关于 md-to-docx

将 Markdown 文件转换为带格式的 Word 文档，并嵌入 PNG 图片。该技能使用 JavaScript 包生成标题页、目录和样式化内容，无需原生二进制程序。

主要功能

  1. 01Markdown 转 DOCX
  2. 02根据 YAML 前置元数据生成标题页
  3. 03从 H1–H3 生成目录
  4. 04内嵌 PNG 图片
  5. 05样式化表格与代码块
  6. 06支持多种 Markdown 元素

适用场景

  1. 01将 Markdown 报告转为 Word 文档
  2. 02制作含标题页和目录的文档
  3. 03转换包含 PNG 图表的 Markdown

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/md-to-docx确认已加载。

附带文件scripts/md-to-docx.mjsscripts/package.json

详细介绍

Markdown 转 Word（.docx）技能

将 Markdown（.md）文件转换为格式专业的 Word（.docx）文档，并嵌入 PNG 图片。通过 docx 和 marked npm 包使用纯 JavaScript 实现 —— 无需 Pandoc、LibreOffice 或任何原生二进制文件。

如何转换

# 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]

如果省略 output.docx，则默认为当前目录下的 <input-basename>.docx。

技能文件夹内容

文件用途
SKILL.md本说明文件
scripts/md-to-docx.mjsNode.js Markdown 转 Word 转换器
scripts/package.json依赖项（docx、marked）

前提条件

要求版本说明
Node.js18+必需运行时
docx9+纯 JS Word 文档生成器
marked15+Markdown 解析器

无需原生二进制文件。无需系统级安装。可在 Windows、macOS 和 Linux 上运行。

功能

该转换器：

  • 提取 YAML front-matter —— 使用 title、date、version、audience 生成标题页
  • 生成标题页 —— 包含项目名称、副标题、日期、版本和受众
  • 生成目录 —— 基于 H1-H3 标题构建
  • 嵌入 PNG 图片 —— 相对于输入 .md 文件解析 ![alt](path) 引用，读取 PNG，并将其内联嵌入 Word 文档
  • 样式化输出 —— Calibri 字体、彩色标题（#1F3864）、带交替行颜色的样式化表格、Consolas 字体的代码块
  • 处理所有 Markdown 元素 —— 标题、段落、表格、代码块、列表、图片、链接、水平分割线

图片嵌入

该转换器会自动嵌入 Markdown 中引用的 PNG 图片：

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

图片路径相对于输入 Markdown 文件进行解析。读取 PNG，从 PNG 头中提取尺寸，并将图片缩放至 6 英寸宽度以内，同时保持宽高比。

如果未找到图片文件，则插入占位符 [Image not found: <path>]。

Front-Matter 格式

---
title: Project Name — Project Summary
date: 2025-01-15
version: 1.0
audience: Engineering Team, Architects, Stakeholders
---

标题会按 — 或 – 拆分为主标题和副标题，用于标题页。

评论

支持 Markdown