Md To Word — AI skill for Claude Code

md-to-word：专为 AI Agent 与 Markdown 打造的规范 Word 排版技能

[](https://github.com/1c7/chinese-independent-developer/blob/master/.github/pages/README-Programmer-Edition.md) [](https://github.com/ls-open/md-to-word/releases/tag/v1.2.0) [](LICENSE) [](https://www.python.org/)

[English](README_EN.md) | [简体中文](README.md)

**用纯文本与 Git 挥洒思想，让 AI 全自动交付规范的 Word（`.docx`）文档。** 一键直出符合**中国高校硕博学位论文、中文核心学术期刊、企业级技术白皮书与规范公文**排版标准的 Word 文件。

---

💡 为什么坚持 Markdown + md-to-word？

在长篇学术论文、专业技术报告与商业白皮书的撰写中，许多团队都经历过 Word 带来的协作阵痛：

• Word（.docx）是封闭的二进制黑盒：Git 无法对其进行行级差异对比（diff），改动全凭肉眼；多人协作时分支合并（merge）极易损坏文件，团队只能依靠“论文_终稿_v2_定稿_真的不改了.docx”痛苦传递。
• 排版耗费大量非生产性时间：在 Word 中反复刷样式、手动断开分节符、调整三线表边框、狂按空格硬凑公式对齐；一旦源文字稍作修改，排版往往前功尽弃。

**md-to-word 提供的现代化工作流**：

1. 内容与排版彻底解耦：作者在纯文本 Markdown 中专注逻辑与思考，享受 Git 版本分支、代码审查（PR）与持续集成的全部工程红利；
2. AI Agent 原生友好：大语言模型天然精通 Markdown，配合本技能可直接全流程闭环完成规范排版；
3. 确定性交付：通过纯净 Word 365 底模与中文声明式规则，全自动输出符合严格审查标准的规范 Word。

---

⚡ 30 秒看懂：你写的 vs 你得到的

排版规则写在 `requirements.txt` 里——**一行一条，进 Git 能 diff**，不用在 Word 里点。

**你写的**（[`demo/00_quickstart/hello.md`](demo/00_quickstart/hello.md)，节选）：

---
title: "我的第一份规范 Word 文档"
crossref:
  tbl-prefix: "表"
---

# 引言

这是一份最小样例：一页纸、二十六行 Markdown。中文首行缩进两个字符、西文用
Times New Roman、行距 1.5 倍、各级标题黑体——这些都不用你在 Word 里点。

# 一个三线表

| 样例 | 篇幅 | 稳定耗时 | 主要演示的排版要素 |
|:------|:--|:---|:--------------|
| 最小样例（本文） | 1 页 | 0.95 s | 中西文字体、首行缩进、多级标题、三线表 |
| 技术白皮书样例 | 3 页 | 1.03 s | 全网格数据表、APA 引用、单线极简页眉 |
| 学位论文样例 | 8 页 | 1.15 s | 目录、分节页码、双线章名页眉、跨页表头 |

…（表格上方的表题包裹块、表注与正文段落见源文件）

**你声明的**（[`demo/00_quickstart/requirements.txt`](demo/00_quickstart/requirements.txt)，全部 16 行）：

纸张：A4
页边距：上