release: 发布 v0.5.0

新增共享 Preview Engine，统一 Web 连续预览、快速分页、Playwright PDF 与 Electron PDF；实现稳定前缀复用和修改位置后的增量分页，保留媒体块按文档顺序串行回填与单次重排。

完善跨端链接与桌面文档工作流：Web 受控处理锚点和 HTTP/HTTPS 外链；Desktop 支持本地路径、file URI、系统协议、多窗口、同文件单例、Markdown 当前或新窗口打开，以及聚焦时外部文件变化提示。

统一四套内置主题名称并默认使用 Typora Github；修复连续预览双滚动条、ECharts 尺寸、PDF 本地链接、围栏代码块 Typora DOM 与重复行内样式；桌面发行链强制完整重建内嵌 Web，避免安装包携带陈旧资源。

发布 Web/Compose 与 Windows NSIS/ZIP：镜像 yixiong/md-to-pdf:v0.5.0 已健康部署；NSIS SHA-256 为 60992D1FDCA513F46346C78478537EB4159D8C0E76B41ECF3CDC25BE77707D92，ZIP SHA-256 为 D74F82293FB67126E583546CBA894569EFC9A0B1B6343FAC648CCC95F1D188D8，本机安装版已升级至 v0.5.0。

验证：全项目 238 项测试通过，类型检查、生产构建和 git diff --check 通过；Web 快速/连续/精确预览、Compose、Desktop 多窗口、窗口状态、文件关联、链接与代码块均完成真实环境验收。

packages/renderer/README.md

@@ -17,10 +17,12 @@ tests/
 ## 支持能力
 
 - 标题锚点、表格、任务列表、脚注和代码高亮；
+- markdown-it 原生围栏代码块及 Typora `.md-fences` DOM 兼容；
 - KaTeX 数学公式；
 - Mermaid 安全占位；
 - `@md-to-pdf/markdown-echarts` ECharts YAML 围栏；
 - 图片标题 DOM 与资源引用收集；
+- 保留由 Web/Desktop 平台适配器处理的安全文档链接；
 - `sanitize-html` 白名单过滤和统一 `<article id="write">` 输出。
 
 ## 使用
@@ -33,6 +35,16 @@ const result = renderMarkdown("# 示例", {
 });
 ```
 
+普通围栏代码块输出为：
+
+```html
+<pre class="md-fences" lang="ts"><code class="language-ts">...</code></pre>
+```
+
+`.md-fences` 让 Typora 主题负责完整代码块外观；共享预览引擎会移除内部
+`code` 重复套用的行内代码盒模型，同时保留 highlight.js 的高亮 span。
+Mermaid 和 ECharts 围栏继续使用各自的专用 DOM，不经过该分支。
+
 实际应用优先通过 `@md-to-pdf/application` 调用，以便同时完成主题和图片
 资源处理。
 

packages/renderer/src/render-markdown.ts

@@ -7,6 +7,10 @@ import type {
   RenderedMarkdownDocument,
   ThemeFeature
 } from "@md-to-pdf/core";
+import {
+  classifyDocumentLink,
+  isSafeDocumentLink
+} from "@md-to-pdf/core";
 import {
   markdownItECharts,
   type MarkdownItEChartsErrorContext
@@ -85,6 +89,11 @@ const markdown = new MarkdownIt(markdownOptions)
     trust: false
   });
 
+const defaultValidateLink = markdown.validateLink.bind(markdown);
+markdown.validateLink = (href) =>
+  defaultValidateLink(href) ||
+  classifyDocumentLink(href).scheme === "file";
+
 const defaultFenceRenderer = markdown.renderer.rules.fence;
 const defaultImageRenderer = markdown.renderer.rules.image;
 const defaultParagraphOpenRenderer =
@@ -178,13 +187,21 @@ markdown.renderer.rules.fence = (
   }
 
   if (defaultFenceRenderer) {
-    return defaultFenceRenderer(
+    const renderedFence = defaultFenceRenderer(
       tokens,
       index,
       options,
       environment,
       renderer
     );
+    const languageAttribute = language
+      ? ` lang="${escapeAttribute(language)}"`
+      : "";
+
+    return renderedFence.replace(
+      /^<pre>/u,
+      `<pre class="md-fences"${languageAttribute}>`
+    );
   }
 
   return renderFallbackFence(tokens, index, renderer);
@@ -270,7 +287,7 @@ const safeHtmlOptions: sanitizeHtml.IOptions = {
     input: ["type", "checked", "disabled", "class"],
     li: ["class", "value"],
     ol: ["class", "start"],
-    pre: ["class", "hidden"],
+    pre: ["class", "hidden", "lang"],
     span: ["class", "style"],
     td: ["colspan", "rowspan", "style"],
     th: ["colspan", "rowspan", "scope", "style"]
@@ -279,6 +296,7 @@ const safeHtmlOptions: sanitizeHtml.IOptions = {
   allowedSchemesByTag: {
     img: ["http", "https", "data"]
   },
+  allowedSchemesAppliedToAttributes: ["src", "cite"],
   allowedStyles: {
     span: {
       height: [lengthStylePattern],
@@ -299,9 +317,19 @@ const safeHtmlOptions: sanitizeHtml.IOptions = {
     }
   },
   transformTags: {
-    a: sanitizeHtml.simpleTransform("a", {
-      rel: "noopener noreferrer"
-    })
+    a(tagName, attributes) {
+      const href = attributes.href;
+      if (href && !isSafeDocumentLink(href)) {
+        delete attributes.href;
+      }
+      return {
+        tagName,
+        attribs: {
+          ...attributes,
+          rel: "noopener noreferrer"
+        }
+      };
+    }
   }
 };
 

packages/renderer/tests/render-markdown.test.ts

@@ -37,6 +37,26 @@ const answer = 42;
     );
   });
 
+  it("为围栏代码块输出 Typora 主题兼容容器", () => {
+    const result = renderMarkdown(`
+\`\`\`
+无语言代码块
+\`\`\`
+
+\`\`\`ts
+const answer = 42;
+\`\`\`
+`);
+
+    expect(result.bodyHtml).toContain(
+      '<pre class="md-fences"><code>无语言代码块\n</code></pre>'
+    );
+    expect(result.bodyHtml).toContain(
+      '<pre class="md-fences" lang="ts"><code class="language-ts">'
+    );
+    expect(result.bodyHtml).toContain("hljs-keyword");
+  });
+
   it("保留 Markdown 表格的列对齐语义", () => {
     const result = renderMarkdown(`
 | 左对齐 | 居中 | 右对齐 |
@@ -211,6 +231,38 @@ option:
     expect(result.bodyHtml).toContain("&lt;script&gt;");
   });
 
+  it("保留平台适配器可处理的文档链接", () => {
+    const result = renderMarkdown(`
+[锚点](#章节一)
+[网络](https://example.com/a)
+[协议相对](//example.com/a)
+[邮件](mailto:a@example.com)
+[电话](tel:+8612345)
+[上级目录](../docs/a.md)
+[绝对路径](C:/docs/a.md)
+[本地 URI](<file:///C:/docs/a.md>)
+[自定义协议](obsidian://open?vault=x)
+`);
+
+    expect(result.bodyHtml).toContain('href="#%E7%AB%A0%E8%8A%82%E4%B8%80"');
+    expect(result.bodyHtml).toContain(
+      'href="https://example.com/a"'
+    );
+    expect(result.bodyHtml).toContain('href="//example.com/a"');
+    expect(result.bodyHtml).toContain(
+      'href="mailto:a@example.com"'
+    );
+    expect(result.bodyHtml).toContain('href="tel:+8612345"');
+    expect(result.bodyHtml).toContain('href="../docs/a.md"');
+    expect(result.bodyHtml).toContain('href="C:/docs/a.md"');
+    expect(result.bodyHtml).toContain(
+      'href="file:///C:/docs/a.md"'
+    );
+    expect(result.bodyHtml).toContain(
+      'href="obsidian://open?vault=x"'
+    );
+  });
+
   it("提取图片引用并使用受控资源地址替换", () => {
     const source =
       "![本地](./文档.assets/a%20b.png)\n\n![远程](https://example.com/a.png)";