@v1hz/md2docx 2.1.1 → 2.2.0

package/README.md

@@ -26,6 +26,7 @@
 | Mermaid 图表      | 使用 beautiful-mermaid 和 resvg-wasm 将 Mermaid 渲染为高 DPI PNG   |
 | Word 样式         | 根据 JSON 样式生成 Pandoc reference DOCX，也可从现有 DOCX 提取样式 |
 | Markdown 格式化   | 可只运行预处理流水线，输出格式化后的 Markdown                      |
+| 去除分隔符        | 默认移除 `---`、`***`、`___` 等分隔符行，减少无用页面间距          |
 | 集中缓存          | 中间文件统一存储到 `~/.md2docx/`，不会在当前目录创建 `tmp/`        |
 | Node 与可执行版本 | 支持 npm CLI，也支持构建不依赖 Node.js/Bun 的 Windows 可执行文件   |
 
@@ -208,6 +209,7 @@ CLI 不支持覆盖单个配置项，所有配置都通过 JSON 文件管理。
 | `renderMermaid.enabled`          | 将 Mermaid 渲染为 PNG                          | `true`                |
 | `renderMermaid.theme`            | beautiful-mermaid 主题                         | `"tokyo-night-light"` |
 | `renderMermaid.density`          | PNG 输出 DPI，最小值 72                        | `200`                 |
+| `removeThematicBreaks.enabled`   | 移除 `---`、`***`、`___` 等分隔符行            | `true`                |
 
 ## 样式定制
 
@@ -268,6 +270,8 @@ Markdown
     ↓
 addTitle()
     ↓
+removeThematicBreaks()
+    ↓
 normalizeHeadings()
     ↓
 numberHeadings()
@@ -287,6 +291,7 @@ Pandoc + Lua filter
 DOCX
 ```
 
+`removeThematicBreaks()` 在标题处理之前执行，避免分隔符干扰文档结构。
 `numberTables()` 必须先于 Mermaid 渲染；`numberPictures()` 必须后于 Mermaid 渲染，这样 Mermaid 生成的图片也能获得图题。
 
 ## 构建

package/config/config.json

@@ -26,5 +26,8 @@
   "detectTitle": {
     "enabled": true,
     "strategy": "first-h1"
+  },
+  "removeThematicBreaks": {
+    "enabled": true
   }
 }

package/config/config.schema.json

@@ -141,6 +141,19 @@
         }
       },
       "required": ["enabled", "strategy"]
+    },
+    "removeThematicBreaks": {
+      "description": "分隔符",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "description": "自动移除 markdown 中的分隔符（---, ***, ___）",
+          "type": "boolean",
+          "default": true
+        }
+      },
+      "required": ["enabled"]
     }
   },
   "required": [
@@ -149,6 +162,7 @@
     "normalizeHeadings",
     "numberHeadings",
     "renderMermaid",
-    "detectTitle"
+    "detectTitle",
+    "removeThematicBreaks"
   ]
 }

package/dist/index.js

@@ -128401,7 +128401,7 @@ import { fileURLToPath as fileURLToPath3 } from "node:url";
 // package.json
 var package_default = {
   name: "@v1hz/md2docx",
-  version: "2.1.1",
+  version: "2.2.0",
   description: "基于 pandoc 的 Markdown 转 Word 工具，自动格式化 Markdown，支持自定义样式，AI 友好，用户友好。",
   keywords: [
     "converter",
@@ -128595,6 +128595,7 @@ function validateConfig(value, path2) {
   if (!Number.isInteger(mermaid.density) || mermaid.density < 72) {
     invalidConfig(path2, "renderMermaid.density", "必须是不小于 72 的整数");
   }
+  validateEnabled(root.removeThematicBreaks, path2, "removeThematicBreaks");
   const title = expectRecord(root.detectTitle, path2, "detectTitle");
   expectBoolean(title.enabled, path2, "detectTitle.enabled");
   const strategy = expectString(title.strategy, path2, "detectTitle.strategy");
@@ -146041,6 +146042,11 @@ function expandHexColor(color2) {
   return color2.length === 4 ? `#${color2[1]}${color2[1]}${color2[2]}${color2[2]}${color2[3]}${color2[3]}` : color2;
 }
 
+// src/preprocess/thematic-break.ts
+function removeThematicBreaks(root2) {
+  root2.children = root2.children.filter((node2) => node2.type !== "thematicBreak");
+}
+
 // src/preprocess/index.ts
 async function preprocess2(mdPath, cfg, outDir, assetUrlDir = outDir) {
   const md = await readFile3(mdPath, "utf-8");
@@ -146051,6 +146057,9 @@ async function preprocess2(mdPath, cfg, outDir, assetUrlDir = outDir) {
     headings.push(heading2);
   });
   addTitle(mdPath, ast, headings, cfg.detectTitle);
+  if (cfg.removeThematicBreaks.enabled) {
+    removeThematicBreaks(ast);
+  }
   if (cfg.normalizeHeadings.enabled || cfg.numberHeadings.enabled) {
     normalizeHeadings(headings);
   }
@@ -146102,6 +146111,9 @@ var config_default = `{
   "detectTitle": {
     "enabled": true,
     "strategy": "first-h1"
+  },
+  "removeThematicBreaks": {
+    "enabled": true
   }
 }
 `;

package/package.json

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