@v1hz/md2docx 2.1.0 → 2.1.1

package/README.md

@@ -27,7 +27,7 @@
 | 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 +178,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。推荐先导出再编辑：
@@ -320,13 +322,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 +352,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/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.1.1",
   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";
@@ -147166,6 +147166,7 @@ async function convertMarkdown(options) {
     markdownOutput,
     "-o",
     output,
+    ...buildPandocResourcePathArgs(input),
     `--reference-doc=${templatePath}`,
     ...existsSync6(luaFilter) ? [`--lua-filter=${luaFilter}`] : []
   ];
@@ -147175,8 +147176,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 +147191,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 +147840,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 +147851,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.1.1",
   "description": "基于 pandoc 的 Markdown 转 Word 工具，自动格式化 Markdown，支持自定义样式，AI 友好，用户友好。",
   "keywords": [
     "converter",