@v1hz/md2docx 1.5.0 → 1.6.0

package/README.md

@@ -19,17 +19,17 @@
 
 将 Markdown 转换为格式精美的 Word 文档，自动处理：
 
-| 功能               | 说明                                                       |
-| ------------------ | ---------------------------------------------------------- |
-| **文档标题**       | 从 frontmatter、H1 或文件名自动提取                        |
-| **标题层级归一化** | 修正标题层级跳跃，确保从 H1 开始连续递增                   |
-| **标题编号**       | 为标题添加多级编号（1、1.1、1.1.1 …），支持剥离已有编号    |
-| **表格编号**       | 自动为表格添加编号（表 1、表 2 …）                         |
-| **图片编号**       | 为独立图片添加编号（图 1、图 2 …）                         |
-| **Mermaid 图表**   | 将 Mermaid 代码块渲染为 PNG 图片                           |
-| **Word 导出**      | 集成 pandoc，传入自定义样式模板，一键生成 .docx            |
-| **样式定制**       | 通过 `style/style.json` 定义文档样式，支持从模板 docx 提取 |
-| **web 配置编辑器** | 浏览器中可视化编辑配置                                     |
+| 功能               | 说明                                                        |
+| ------------------ | ----------------------------------------------------------- |
+| **文档标题**       | 从 frontmatter、H1 或文件名自动提取                         |
+| **标题层级归一化** | 修正标题层级跳跃，确保从 H1 开始连续递增                    |
+| **标题编号**       | 为标题添加多级编号（1、1.1、1.1.1 …），支持剥离已有编号     |
+| **表格编号**       | 自动为表格添加编号（表 1、表 2 …）                          |
+| **图片编号**       | 为独立图片添加编号（图 1、图 2 …）                          |
+| **Mermaid 图表**   | 将 Mermaid 代码块渲染为 PNG 图片                            |
+| **Word 导出**      | 集成 pandoc，传入自定义样式模板，一键生成 .docx             |
+| **样式定制**       | 通过 `config/style.json` 定义文档样式，支持从模板 docx 提取 |
+| **web 配置编辑器** | 浏览器中可视化编辑配置                                      |
 
 ## 安装
 
@@ -98,9 +98,19 @@ md2docx docs/example.md --figureCaption.enabled false
 
 `config/style.json` 定义了 docx 输出的全部样式，包括字体、字号、颜色、缩进、间距等。
 
+### 从模板 docx 提取样式
+
+如果你有一个排版精美的 docx 模板，可以提取其样式：
+
+```bash
+bun run src/style/extract.ts
+```
+
+提取后修改 `config/style.json`，转换时会自动使用这些样式生成输出文档。
+
 ### 手动维护样式
 
-可直接编辑 `style/style.json`。支持以下样式配置：
+可直接编辑 `config/style.json`。支持以下样式配置：
 
 - **文档默认样式**（`default.document`）：全局字体、字号、段落间距
 - **内置样式覆盖**（`default.heading1` … `default.heading6`、`default.title` 等）
@@ -132,7 +142,7 @@ numberPictures()      ← 添加图片编号（图 1、图 2 …）
     ↓
 序列化 Markdown
     ↓
-生成样式模板 docx     ← 根据 style/style.json 生成 pandoc reference-doc
+生成样式模板 docx     ← 根据 config/style.json 生成 pandoc reference-doc
     ↓
 pandoc → DOCX         ← 以 --reference-doc 传入样式模板
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v1hz/md2docx",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "基于 pandoc 的 Markdown 转 Word 工具，自动格式化 Markdown，支持自定义样式，AI 友好，用户友好。",
   "keywords": [
     "converter",

package/src/style/generate.ts

@@ -8,7 +8,10 @@ import { STYLE_TEMPLATE_DOCX } from "../paths";
  *
  * @param styleJsonPath - 样式 JSON 文件路径（如 config/style.json）
  */
-export async function generateTemplateDocx(styleJsonPath: string): Promise<void> {
+export async function generateTemplateDocx(
+  styleJsonPath: string,
+  outputPath: string = STYLE_TEMPLATE_DOCX,
+): Promise<void> {
   const raw = JSON.parse(readFileSync(styleJsonPath, "utf-8")) as Record<string, unknown>;
   const tableStylesXml = raw.tableStylesXml as string | undefined;
   // 移除 tableStylesXml，docx 包不识别它
@@ -19,7 +22,7 @@ export async function generateTemplateDocx(styleJsonPath: string): Promise<void>
     sections: [],
   });
   const buf = await Packer.toBuffer(doc);
-  mkdirSync(dirname(STYLE_TEMPLATE_DOCX), { recursive: true });
+  mkdirSync(dirname(outputPath), { recursive: true });
 
   // 如果有表格样式 XML，注入到生成的 docx 中
   if (tableStylesXml) {
@@ -32,12 +35,12 @@ export async function generateTemplateDocx(styleJsonPath: string): Promise<void>
       const injectedXml = originalXml.replace("</w:styles>", tableStylesXml + "</w:styles>");
       zip.file("word/styles.xml", injectedXml);
       const modifiedBuf = zip.generate({ type: "nodebuffer" }) as Buffer;
-      await Bun.write(STYLE_TEMPLATE_DOCX, modifiedBuf);
+      await Bun.write(outputPath, modifiedBuf);
       return;
     }
   }
 
-  await Bun.write(STYLE_TEMPLATE_DOCX, buf);
+  await Bun.write(outputPath, buf);
 }
 
 let _generatePromise: Promise<void> | null = null;