@v1hz/md2docx 2.1.0 → 2.2.0

package/README.md

@@ -26,8 +26,9 @@
 | Mermaid 图表      | 使用 beautiful-mermaid 和 resvg-wasm 将 Mermaid 渲染为高 DPI PNG   |
 | Word 样式         | 根据 JSON 样式生成 Pandoc reference DOCX，也可从现有 DOCX 提取样式 |
 | Markdown 格式化   | 可只运行预处理流水线，输出格式化后的 Markdown                      |
+| 去除分隔符        | 默认移除 `---`、`***`、`___` 等分隔符行，减少无用页面间距          |
 | 集中缓存          | 中间文件统一存储到 `~/.md2docx/`，不会在当前目录创建 `tmp/`        |
-| Node 与可执行版本 | 支持 npm CLI，也支持构建不依赖 Node.js/Bun 的平台可执行文件        |
+| Node 与可执行版本 | 支持 npm CLI，也支持构建不依赖 Node.js/Bun 的 Windows 可执行文件   |
 
 ## 安装方式
 
@@ -178,6 +179,8 @@ md2docx export style -f template.docx → ./template_style.json
 
 输出 DOCX 和显式导出的配置、样式仍写到用户指定位置或当前工作目录，不会写入缓存目录。
 
+虽然 Pandoc 实际读取的是缓存中的格式化 Markdown，但本地相对资源始终优先相对于**原始 Markdown 所在目录**解析；找不到时再搜索命令运行目录。例如 `C:/docs/example.md` 中的 `./pictures/test.png` 会解析为 `C:/docs/pictures/test.png`，与从哪个目录执行 `md2docx` 无关。绝对路径、HTTP(S) URL 和 Mermaid 生成的缓存图片不受影响。
+
 ## 配置
 
 内置配置来自 `config/config.json`，并由 `config/config.schema.json` 提供 JSON Schema。推荐先导出再编辑：
@@ -206,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`                |
 
 ## 样式定制
 
@@ -266,6 +270,8 @@ Markdown
     ↓
 addTitle()
     ↓
+removeThematicBreaks()
+    ↓
 normalizeHeadings()
     ↓
 numberHeadings()
@@ -285,6 +291,7 @@ Pandoc + Lua filter
 DOCX
 ```
 
+`removeThematicBreaks()` 在标题处理之前执行，避免分隔符干扰文档结构。
 `numberTables()` 必须先于 Mermaid 渲染；`numberPictures()` 必须后于 Mermaid 渲染，这样 Mermaid 生成的图片也能获得图题。
 
 ## 构建
@@ -320,13 +327,13 @@ dist/
 
 依赖会打包进 `index.js`，resvg WASM 作为相邻资源输出。`prepack` 会自动执行此构建。
 
-### 平台可执行文件
+### Windows 可执行文件
 
 ```bash
 bun run build:exe
 ```
 
-Windows 输出为 `dist/md2docx.exe`。该程序只适用于构建目标对应的操作系统和 CPU 架构。
+Windows 输出为 `dist/md2docx.exe`。
 
 `build` 和 `build:exe` 都会先删除整个 `dist/`，因此两种产物不会同时保留。尤其不要依赖手工生成的 EXE 参与 `npm publish`：发布时 `prepack` 会重新生成 npm 所需的 `index.js` 和 WASM。
 
@@ -350,6 +357,23 @@ pandoc --version
 md2docx -f report.md --force
 ```
 
+### 从其他目录转换时图片缺失
+
+相对图片路径应以原始 Markdown 文件为基准：
+
+```text
+docs/
+├── example.md
+└── pictures/
+    └── test.png
+```
+
+```markdown
+![](./pictures/test.png)
+```
+
+新版会把原始文档目录和命令运行目录传给 Pandoc 的 `--resource-path`，并优先搜索原始文档目录。如果仍然缺图，请检查路径大小写、文件是否存在，以及图片语法中是否包含错误的 URL 编码。
+
 ## 许可
 
 md2docx 以 [GNU GPL v3.0](LICENSE) 发布。

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.0",
+  version: "2.2.0",
   description: "基于 pandoc 的 Markdown 转 Word 工具，自动格式化 Markdown，支持自定义样式，AI 友好，用户友好。",
   keywords: [
     "converter",
@@ -128553,7 +128553,7 @@ function cleanIntermediateFiles(paths = { targetDir: TMP_DIR, homeDir: homedir2(
 // src/commands/convert.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync5, writeFileSync as writeFileSync3 } from "node:fs";
 import { spawn } from "node:child_process";
-import { parse as parse4 } from "node:path";
+import { dirname as dirname5, parse as parse4, resolve as resolve5 } from "node:path";
 
 // src/config.ts
 import { access, readFile } from "node:fs/promises";
@@ -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
   }
 }
 `;
@@ -147166,6 +147178,7 @@ async function convertMarkdown(options) {
     markdownOutput,
     "-o",
     output,
+    ...buildPandocResourcePathArgs(input),
     `--reference-doc=${templatePath}`,
     ...existsSync6(luaFilter) ? [`--lua-filter=${luaFilter}`] : []
   ];
@@ -147175,8 +147188,14 @@ async function convertMarkdown(options) {
   }
   console.log(`已生成：${output}`);
 }
+function buildPandocResourcePathArgs(inputPath, workingDirectory = process.cwd()) {
+  const workingDir = resolve5(workingDirectory);
+  const sourceDir = dirname5(resolve5(inputPath));
+  const searchDirs = workingDir === sourceDir ? [sourceDir] : [workingDir, sourceDir];
+  return searchDirs.map((directory) => `--resource-path=${directory}`);
+}
 function runProcess(command, args) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const child = spawn(command, args, { stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
     let stderr = "";
     child.stderr.setEncoding("utf-8");
@@ -147184,7 +147203,7 @@ function runProcess(command, args) {
       stderr += chunk;
     });
     child.once("error", reject);
-    child.once("close", (exitCode) => resolve5({ exitCode: exitCode ?? 1, stderr }));
+    child.once("close", (exitCode) => resolve6({ exitCode: exitCode ?? 1, stderr }));
   });
 }
 
@@ -147833,7 +147852,7 @@ async function exportStyle(options) {
 
 // src/commands/format.ts
 import { existsSync as existsSync7, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "node:fs";
-import { basename, dirname as dirname5, parse as parse6, resolve as resolve5 } from "node:path";
+import { basename, dirname as dirname6, parse as parse6, resolve as resolve6 } from "node:path";
 async function formatMarkdown(options) {
   const input = resolveInputPath(options.file, [".md", ".markdown"], "Markdown 文件");
   const configPath = options.config ? resolveInputPath(options.config, [".json"], "配置文件") : materializeDefaultConfig();
@@ -147844,14 +147863,14 @@ async function formatMarkdown(options) {
   const config = await loadConfig(configPath);
   const outputName = parse6(output).name;
   const assetsName = `${outputName}_assets`;
-  const assetsDir = resolve5(dirname5(output), assetsName);
+  const assetsDir = resolve6(dirname6(output), assetsName);
   if (config.renderMermaid.enabled && existsSync7(assetsDir)) {
     if (!force) {
       throw new Error(`资源目录已存在：${assetsDir}
 使用 --force 覆盖现有目录`);
     }
-    const parent = resolve5(dirname5(output));
-    if (dirname5(assetsDir) !== parent)
+    const parent = resolve6(dirname6(output));
+    if (dirname6(assetsDir) !== parent)
       throw new Error(`拒绝清理非输出目录：${assetsDir}`);
     rmSync2(assetsDir, { recursive: true, force: true });
   }

package/package.json

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