markdown-to-docx

用途

markdown-to-docx 用于将 Markdown 文件转换为 Microsoft Word（.docx）格式，生成可编辑的 Word 文档，并尽量保留原始 Markdown 的结构与格式。

主要能力

• GFM 支持：表格、删除线、任务列表。
• 代码块：保留语法并以等宽字体呈现。
• 图片：支持本地图片与 URL 图片并嵌入文档。
• 数学公式：默认渲染 LaTeX 公式（$...$、$$...$$）。
• Frontmatter：解析 YAML 元数据并用于标题。
• 无系统依赖：纯 JavaScript 实现，无需 Chrome。

安装

该技能需要 npm 依赖。可任选其一：

（1）ClaudeKit CLI（推荐）：

ck init

（2）手动安装：

cd .claude/skills/markdown-to-docx
npm install

依赖：markdown-docx、gray-matter。

使用方式

基本转换：

node .claude/skills/markdown-to-docx/scripts/convert.cjs --input ./README.md

指定输出路径：

node .claude/skills/markdown-to-docx/scripts/convert.cjs -i ./doc.md -o ./output.docx

使用自定义主题：

node .claude/skills/markdown-to-docx/scripts/convert.cjs -i ./doc.md --theme ./theme.json

CLI 选项：

Option	Short	Description	Default
--input	-i	Input markdown file	(required)
--output	-o	Output DOCX path	{input}.docx
--theme	-t	Custom theme JSON	built-in
--title		Document title	filename
--help	-h	Show help

成功时返回 JSON：

{
    "success": true,
    "input": "/path/to/input.md",
    "output": "/path/to/output.docx"
}

适用场景

• 需要把 Markdown 文档交付为 Word 文档进行编辑或评审。
• 文档中包含表格、代码、图片或 LaTeX 数学公式，且希望转换后保留这些内容。
• 需要为文档套用自定义样式模板（reference.docx / theme）。

限制

• 需要系统安装 pandoc（被视为必需依赖）。
• 需要安装 npm 依赖 markdown-docx、gray-matter。
• 技能文档中包含大量面向特定 AI 工具环境（如 Codex、Claude）的执行协议、任务跟踪、子代理授权、项目协议叠加等约定；这些属于该技能所在工程的工作流约束，并非转换功能本身。
• 具体收费、价格、平台等信息暂未提供。