Files
MorphDoc/packages/renderer
SkyJourney 64445322eb release: 发布 v0.6.2 DOCX 真实文档修复
新增能力:将 DOCX 发布验收拆分为四套独立 140,支持真实语料冻结、指纹复用、失败与基础设施错误独立统计,并为表格换行、全 JSON 围栏、代码连续性和长文档分页建立通用门禁。

问题修复:冻结 Paged.js 分片前的逻辑表格列轨并传递打印几何,统一 Markdown 表格换行、代码、段落与 OOXML 翻译;改进 PDF 文本流排序、语义块映射、颜色与栅格比较,消除窄字符重叠和跨行范围符号误报。

兼容与部署:版本统一为 0.6.2;正式 Docker 镜像内置固定 Chromium、Pandoc 3.9.0.2 和 Serif/Sans/Mono 字体;Desktop NSIS 与 ZIP 继续直接内置字体,无需系统字体安装。

验证结果:合成基线与长庆严格 280/280,M4N 140/140;健康数据残余误报 6/115(5.22%),均核查为重复表头自动对齐/取样误报且基础设施错误为 0。全项目测试、类型检查、生产构建和 git diff --check 通过;正式 Docker、NSIS、ZIP、离线镜像、部署包、清单及 SHA-256 均已生成并校验。
2026-08-26 10:50:20 +08:00
..
2026-07-28 18:01:22 +08:00

@md-to-pdf/renderer

将 Markdown 转换为统一、安全的 #write HTML 文档。Web 预览、服务端 PDF 和桌面端 PDF 均通过应用服务复用本包,不维护第二套 Markdown 解析 逻辑。

目录结构

src/
  render-markdown.ts  Front Matter、Markdown 扩展、安全过滤与元数据
  index.ts            公共导出入口
tests/
  render-markdown.test.ts

支持能力

  • 标题锚点、表格、任务列表、脚注和代码高亮;
  • markdown-it 原生围栏代码块及 Typora .md-fences DOM 兼容;
  • KaTeX 数学公式;
  • Mermaid 安全占位;
  • @md-to-pdf/markdown-echarts ECharts YAML 围栏;
  • 图片标题 DOM 与资源引用收集;
  • 保留由 Web/Desktop 平台适配器处理的安全文档链接;
  • sanitize-html 白名单过滤和统一 <article id="write"> 输出。

使用

import { renderMarkdown } from "@md-to-pdf/renderer";

const result = renderMarkdown("# 示例", {
  language: "zh-CN"
});

普通围栏代码块输出为:

<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 调用,以便同时完成主题和图片 资源处理。

开发与验证

npm run dev -w @md-to-pdf/renderer
npm run test -w @md-to-pdf/renderer
npm run typecheck -w @md-to-pdf/renderer
npm run build -w @md-to-pdf/renderer